JSPM

  • Created
  • Published
  • Downloads 1534528
  • Score
    100M100P100Q223652F

html loader module for webpack

Package Exports

  • html-loader
  • html-loader/lib/attributesParser

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (html-loader) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

html loader for webpack

Exports HTML as string. HTML is minimized when the compiler demands.

By default every local <img src="image.png"> is required (require("./image.png")). You may need to specify loaders for images in your configuration (recommended file-loader or url-loader).

You can specify which tag-attribute combination should be processed by this loader via the query parameter attrs. Pass an array or a space-separated list of <tag>:<attribute> combinations. (Default: attrs=img:src)

Usage

Documentation: Using loaders

Examples

With this configuration:

{
    module: { loaders: [
        { test: "\.jpg$", loader: "file-loader" },
        { test: "\.png$", loader: "url-loader?mimetype=image/png" }
    ]},
    output: {
        publicPath: "http://cdn.example.com/[hash]/"
    }
}
<!-- fileA.html -->
<img  src="image.jpg"  data-src="image2x.png" >
require("html!./fileA.html");
// => '<img  src="http://cdn.example.com/49e...ba9f/a9f...92ca.jpg"  data-src="image2x.png" >'

require("html?attrs=img:data-src!./file.html");
// => '<img  src="image.png"  data-src="data:image/png;base64,..." >'

require("html?attrs=img:src img:data-src!./file.html");
require("html?attrs[]=img:src&attrs[]=img:data-src!./file.html");
// => '<img  src="http://cdn.example.com/49e...ba9f/a9f...92ca.jpg"  data-src="data:image/png;base64,..." >'

/// minimized by running `webpack --optimize-minimize`
// => '<img src=http://cdn.example.com/49e...ba9f/a9f...92ca.jpg data-src=data:image/png;base64,...>'

'Root-relative' urls

For urls that start with a /, the default behavior is to not translate them. If a root query parameter is set, however, it will be prepended to the url and then translated.

With the same configuration above:

<!-- fileB.html -->
<img src="/image.jpg">
require("html!./fileB.html");
// => '<img  src="/image.jpg">'

require("html?root=.!./fileB.html");
// => '<img  src="http://cdn.example.com/49e...ba9f/a9f...92ca.jpg">'

License

MIT (http://www.opensource.org/licenses/mit-license.php)