1. HTML Loader

导出HTML为字符串。当编译器需要时，HTML 是被压缩的。

1.1. 安装

npm i -D html-loader

1.2. 用法

默认情况下，每个本地的 <img src="image.png"> 都需要通过 require （require('./image.png')）来进行加载。您可能需要在配置中为图片指定 loader（推荐 file-loader 或 url-loader ）

您可以通过查询参数 attrs，来指定哪个标签属性组合(tag-attribute combination)应该被此 loader 处理。传递数组或以空格分隔的 <tag>:<attribute>组合的列表。（默认值：attrs=img:src）

如果使用<custom-elements>，而且很多都使用了一个custom-src属性，您不必指定每个组合<tag>:<attribute>:只需指定一个空的标记，就像attrs=:custom-src，它将匹配每个元素。

{
  test: /\.(html)$/,
  use: {
    loader: 'html-loader',
    options: {
      attrs: [':data-src']
    }
  }
}

要完全禁用对标签属性的处理（例如，如果你在客户端处理图片加载），你可以传入 attrs=false。

1.3. 示例

使用这个配置:

{
  module: {
    rules: [
      { test: /\.jpg$/, use: [ "file-loader" ] },
      { test: /\.png$/, use: [ "url-loader?mimetype=image/png" ] }
    ]
  },
  output: {
    publicPath: "http://cdn.example.com/[hash]/"
  }
}

<!-- file.html -->
<img src="image.png" data-src="image2x.png" >

require("html-loader!./file.html");

// => '<img src="http://cdn.example.com/49eba9f/a992ca.png"
//         data-src="image2x.png">'

require("html-loader?attrs=img:data-src!./file.html");

// => '<img src="image.png" data-src="data:image/png;base64,..." >'

require("html-loader?attrs=img:src img:data-src!./file.html");
require("html-loader?attrs[]=img:src&attrs[]=img:data-src!./file.html");

// => '<img  src="http://cdn.example.com/49eba9f/a992ca.png"        
//           data-src="data:image/png;base64,..." >'

require("html-loader?-attrs!./file.html");

// => '<img  src="image.jpg"  data-src="image2x.png" >'

通过运行 webpack --optimize-minimize 来最小化

'<img src=http://cdn.example.com/49eba9f/a9f92ca.jpg
      data-src=data:image/png;base64,...>'

或者在 webpack.conf.js 的 rule 选项中指定 minimize 属性

module: {
  rules: [{
    test: /\.html$/,
    use: [ {
      loader: 'html-loader',
      options: {
        minimize: true
      }
    }],
  }]
}

在默认情况下最小化的规则如下:

removeComments
removeCommentsFromCDATA
removeCDATASectionsFromCDATA
collapseWhitespace
conservativeCollapse
removeAttributeQuotes
useShortDoctype
keepClosingSlash
minifyJS
minifyCSS
removeScriptTypeAttributes
removeStyleTypeAttributes

你可以在webpack.conf.js中使用下面的选项禁用规则：

module: {
  rules: [{
    test: /\.html$/,
    use: [ {
      loader: 'html-loader',
      options: {
        minimize: true,
        removeComments: false,
        collapseWhitespace: false
      }
    }],
  }]
}

1.3.1. 'Root-relative' URLs

对于以 / 开头的 url，默认行为是不转换它们。如果设置了 root 查询参数，它将在被添加到 URL 之前，然后进行转换。

和上面配置相同：

<!-- file.html -->
<img src="/image.jpg">

require("html-loader!./file.html");

// => '<img  src="/image.jpg">'

require("html-loader?root=.!./file.html");

// => '<img  src="http://cdn.example.com/49eba9f/a992ca.jpg">'

1.3.2. 插值

你可以使用插值（interpolate）标记来支持ES6的模板语法。像这样：

require("html-loader?interpolate!./file.html");

<img src="${require(`./images/gallery.png`)}">

<div>${require('./components/gallery.html')}</div>

如果你只想在模板中使用 require，任何其它的 ${} 不被转换，你可以设置 interpolate 标记为 require，就像这样：

// 设置 interpolate
require("html-loader?interpolate=require!./file.ftl");


<#list list as list>
  <a href="${list.href!}" />${list.name}</a>
</#list>

<img src="${require(`./images/gallery.png`)}">

<div>${require('./components/gallery.html')}</div>

1.3.3. 导出格式

有几个不同的export格式可用：

module.exports (默认, cjs format). "Hello world" 变为 module.exports = "Hello world";
exports.default (当 exportAsDefault 参数被设置， es6to5 format). "Hello world" 变为 exports.default = "Hello world";
export default (当 exportAsEs6Default 参数被设置， es6 格式). "Hello world" 变为 export default "Hello world";

1.3.4. 高级选项

如果你需要传递更多高级选项, 尤其是那些不能被严格化的，你可以在 webpack.config.js上设置一个 htmlLoader属性:

var path = require('path')

module.exports = {
  ...
  module: {
    rules: [
      {
        test: /\.html$/,
        use: [ "html-loader" ]
      }
    ]
  },
  htmlLoader: {
    ignoreCustomFragments: [/\{\{.*?}}/],
    root: path.resolve(__dirname, 'assets'),
    attrs: ['img:src', 'link:href']
  }
};

如果你需要定义两个不同的loader配置，你可以通过html-loader?config=otherHtmlLoaderConfig来改变配置的属性名称：

module.exports = {
  ...
  module: {
    rules: [
      {
        test: /\.html$/,
        use: [ "html-loader?config=otherHtmlLoaderConfig" ]
      }
    ]
  },
  otherHtmlLoaderConfig: {
    ...
  }
};

1.3.5. 导出到Html文件

一个很常见的场景，将 HTML 导出到 .html 文件中，来直接访问它们，而不是使用 javascript 注入。这可以通过3个 loader 的组合来实现：

html-loader 将解析 URL，请求图片和你所期望的一切资源。extract-loader 会将 javascript 解析为合适的 html 文件，确保引用的图片指向正确的路径，file-loader 将结果写入 .html 文件。示例：

{
  test: /\.html$/,
  use: [ 'file-loader?name=[path][name].[ext]!extract-loader!html-loader' ]
}

1.4. Maintainers

Hemanth	Joshua Wiens	Michael Ciniawsky	Imvetri
Andrei Crnković	Yuta Hiroto	Vesselin Petrunov	Gajus Kuizinas

html-loader