Webpack实战-为单页应用生成HTML

时间 2019-11-06

标签 webpack 实战单页应用生成 html 栏目 HTML 繁體版

原文原文链接

引入问题

在简单的项目里由于只输出了一个 bundle.js 文件，因此手写了一个 index.html 文件去引入这个 bundle.js，才能让应用在浏览器中运行起来。javascript

在实际项目中远比这复杂，一个页面经常有不少资源要加载。接下来举一个实战中的例子，要求以下：css

项目采用 ES6 语言加 React 框架。
给页面加入 Google Analytics，这部分代码须要内嵌进 HEAD 标签里去。
给页面加入 Disqus 用户评论，这部分代码须要异步加载以提高首屏加载速度。
压缩和分离 JavaScript 和 CSS 代码，提高加载速度。

在开始前先来看看该应用最终发布到线上的代码：html

<html>
<head>
  <meta charset="UTF-8">
  <!--注入 Chunk app 依赖的 CSS-->
  <style rel="stylesheet">h1{color:red}</style>
  <!--内嵌 google_analytics 中的 JavaScript 代码-->
  <script> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','https://www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-XXXXX-Y', 'auto'); ga('send', 'pageview'); </script>
  <!--异步加载 Disqus 评论-->
  <script async="" src="https://dive-into-webpack.disqus.com/embed.js"></script>
</head>
<body>
<div id="app"></div>
<!--导入 app 依赖的 JS-->
<script src="app_746f32b2.js"></script>
<!--Disqus 评论容器-->
<div id="disqus_thread"></div>
</body>
</html>
复制代码

HTML 应该是被压缩过的，这里为了方便你们阅读而格式化了 HTML，而且加入了注释。java

构建出的目录结构为：node

dist
├── app_792b446e.js
└── index.html
复制代码

能够看到部分代码被内嵌进了 HTML 的 HEAD 标签中，部分文件的文件名称被打上根据文件内容算出的 Hash 值，而且加载这些文件的 URL 地址也被正常的注入到了 HTML 中。若是你还采用手写 index.html 文件去完成以上要求，这就会使工做变得复杂、易错，项目难以维护。本节教你如何自动化的生成这个符合要求的 index.html。webpack

解决方案

推荐一个用于方便的解决以上问题的 Webpack 插件 web-webpack-plugin。该插件已经被社区上许多人使用和验证，解决了你们的痛点得到了不少好评，下面具体介绍如何用它来解决上面的问题。git

首先，修改 Webpack 配置为以下：github

const path = require('path');
const UglifyJsPlugin = require('webpack/lib/optimize/UglifyJsPlugin');
const ExtractTextPlugin = require('extract-text-webpack-plugin');
const DefinePlugin = require('webpack/lib/DefinePlugin');
const { WebPlugin } = require('web-webpack-plugin');

module.exports = {
  entry: {
    app: './main.js'// app 的 JavaScript 执行入口文件
  },
  output: {
    filename: '[name]_[chunkhash:8].js',// 给输出的文件名称加上 Hash 值
    path: path.resolve(__dirname, './dist'),
  },
  module: {
    rules: [
      {
        test: /\.js$/,
        use: ['babel-loader'],
        // 排除 node_modules 目录下的文件，
        // 该目录下的文件都是采用的 ES5 语法，不必再经过 Babel 去转换
        exclude: path.resolve(__dirname, 'node_modules'),
      },
      {
        test: /\.css/,// 增长对 CSS 文件的支持
        // 提取出 Chunk 中的 CSS 代码到单独的文件中
        use: ExtractTextPlugin.extract({
          use: ['css-loader?minimize'] // 压缩 CSS 代码
        }),
      },
    ]
  },
  plugins: [
    // 使用本文的主角 WebPlugin，一个 WebPlugin 对应一个 HTML 文件
    new WebPlugin({
      template: './template.html', // HTML 模版文件所在的文件路径
      filename: 'index.html' // 输出的 HTML 的文件名称
    }),
    new ExtractTextPlugin({
      filename: `[name]_[contenthash:8].css`,// 给输出的 CSS 文件名称加上 Hash 值
    }),
    new DefinePlugin({
      // 定义 NODE_ENV 环境变量为 production，以去除源码中只有开发时才须要的部分
      'process.env': {
        NODE_ENV: JSON.stringify('production')
      }
    }),
    // 压缩输出的 JavaScript 代码
    new UglifyJsPlugin({
      // 最紧凑的输出
      beautify: false,
      // 删除全部的注释
      comments: false,
      compress: {
        // 在UglifyJs删除没有用到的代码时不输出警告
        warnings: false,
        // 删除全部的 `console` 语句，能够兼容ie浏览器
        drop_console: true,
        // 内嵌定义了可是只用到一次的变量
        collapse_vars: true,
        // 提取出出现屡次可是没有定义成变量去引用的静态值
        reduce_vars: true,
      }
    }),
  ],
};
复制代码

以上配置中，大多数都是按照前面已经讲过的内容增长的配置，例如：web

增长对 CSS 文件的支持，提取出 Chunk 中的 CSS 代码到单独的文件中，压缩 CSS 文件；
定义 NODE_ENV 环境变量为 production，以去除源码中只有开发时才须要的部分；
给输出的文件名称加上 Hash 值；
压缩输出的 JavaScript 代码。

但最核心的部分在于 plugins 里的：浏览器

new WebPlugin({
  template: './template.html', // HTML 模版文件所在的文件路径
  filename: 'index.html' // 输出的 HTML 的文件名称
})
复制代码

其中 template: './template.html' 所指的模版文件 template.html 的内容是：

<html>
<head>
  <meta charset="UTF-8">
  <!--注入 Chunk app 中的 CSS-->
  <link rel="stylesheet" href="app?_inline">
  <!--注入 google_analytics 中的 JavaScript 代码-->
  <script src="./google_analytics.js?_inline"></script>
  <!--异步加载 Disqus 评论-->
  <script src="https://dive-into-webpack.disqus.com/embed.js" async></script>
</head>
<body>
<div id="app"></div>
<!--导入 Chunk app 中的 JS-->
<script src="app"></script>
<!--Disqus 评论容器-->
<div id="disqus_thread"></div>
</body>
</html>
复制代码

该文件描述了哪些资源须要被以何种方式加入到输出的 HTML 文件中。

以 <link rel="stylesheet" href="app?_inline"> 为例，按照正常引入 CSS 文件同样的语法来引入 Webpack 生产的代码。 href 属性中的 app?_inline 能够分为两部分，前面的 app 表示 CSS 代码来自名叫 app 的 Chunk 中，后面的 _inline 表示这些代码须要被内嵌到这个标签所在的位置。

一样的 <script src="./google_analytics.js?_inline"></script> 表示 JavaScript 代码来自相对于当前模版文件 template.html 的本地文件 ./google_analytics.js，并且文件中的 JavaScript 代码也须要被内嵌到这个标签所在的位置。

也就是说资源连接 URL 字符串里问号前面的部分表示资源内容来自哪里，后面的 querystring 表示这些资源注入的方式。

除了 _inline 表示内嵌外，还支持如下属性：

_dist 只有在生产环境下才引入该资源
_dev 只有在开发环境下才引入该资源
_ie 只有IE浏览器才须要引入的资源，经过 [if IE]>resource<![endif] 注释实现

这些属性之间能够搭配使用，互不冲突。例如 app?_inline&_dist 表示只在生产环境下才引入该资源，而且须要内嵌到 HTML 里去。

WebPlugin 插件还支持一些其它更高级的用法，详情能够访问该项目主页阅读文档。

本实例提供项目完整代码

《深刻浅出Webpack》全书在线阅读连接

阅读原文