webpack搭建React项目（4）

管理模块

module

在 webpack 中，每个文件都是一个模块，除了 webpack 认识的 JS 和 JSON 文件，CSS，图片等都是模块，模块之间通过不同方式的语法会产生依赖关系，例如：

ES6+的import；
CommonJS 的require；
AMD 的define和require；
css/sass/less 文件中的@import，url(...)；
html 文件中可替换元素的src属性

webpack 通过loader来支持多种语言和预处理器语法编写的模块，这样就可以处理各种非 JS 内容。

处理 HTML

HtmlWebpackPlugin

之前的配置是直接在 webpack 的打包输出目录下创建一个 html 页面，并手动引入 webpack 输出的 JS 文件。尽管引入了 WDS，可以自动打开并刷新页面，但是这只是一个 bundle 文件的情况，如果项目模块增多，需要多个 bundle 时，自然无法再手动将 bundle 文件添加到 html 中，所以我们需要一个插件能够将 bundle 文件自动添加到 html 中。

HtmlWebpackPlugin 是在 webpack 打包过程中自动生成 html 页面，并且自动将资源文件，例如 webpack 打包输出的 JS 文件插入到 html 页面中的插件。根据配置，这个插件还能支持根据自定义的模板来生成 html 文件，或者根据ejs的语法规则来替换一些变量。

yarn add html-webpack-plugin -D

配置项

配置项	类型	默认值	用法
`title`	String	`Webpack App`	html 的 title	`filename`	String	`'index.html'`	生产的 html 页面的文件名	`template`	String	`src/index.ejs`	模板页面，如果存在`src/index.ejs`就是用它	`templateContent`	String\|Function\|`false`	`false`	代替模板使用以提供嵌入式模板	`templateParameters`	Boolean\|Object\|Function	`false`	覆盖模板中使用的参数	`inject`	`true	false `<br />`'head'	'body'`	`scriptLoading`	`'blocking'` `'defer'`	`'blocking'`	设置 JS 加载的方式	`favicon`	String	``	将给定的 favicon 路径添加到 html 中	`meta`	Object	{ }	为 html 模板页面添加 meta，参见 —— HEAD#meta	`base`	Object\|String \| `false`	`false`	为 html 模板页面添加 base 标签	`minify`	Boolean \| Object	`true`	根据 webpack 的`mode`配置来判断当前环境，由于`mode`默认是`production`生产环境，所以这个值默认也是`true`，也就是对 html 进行压缩；也可以使用一个对象来配置具体的压缩项目，参见 —— minification	`hash`	Boolean	`false`	如果为`true`，则将唯一的 webpack 编译哈希值附加到所有包含的脚本和 CSS 文件中。这对于清除缓存很有用	`cache`	Boolean	`true`	仅在文件改变时重新生成	`showErrors`	Boolean	`true`	错误详细信息将写入 HTML 页面	`chunks`	Array of String	`?`	自定义添加的模块	`chunksSortMode`	`"none"` `"auto"` `"manual"` Function	`"auto"`	允许控制在将块包含到 HTML 中之前应如何对其进行排序	`excludeChunks`	Array of String		打包时忽略的模块，例如测试模块等	`xhtml`	Boolean	`false`	如果设置成`true`，`link`标签的插入形式将是自动闭合的形式，也就是闭合的箭头括号前多一个斜杠

模板配置

如果不使用自定义的模板，HtmlWebpackPlugin 配置最简单，直接new HtmlWebpackPlugin()就可以了。

const HtmlWebpackPlugin = require("html-webpack-plugin");

module.exports = {
  ...
  plugins: [new HtmlWebpackPlugin()],
}

但是实际项目往往基本都需要自定义模板，HtmlWebpackPlugin 可以根据自定义的模板来生成 html 文件，并将 webpack 的输出资源插入到 html 页面中。

HtmlWebpackPlugin 本身内置识别.ejs文件的 loader，如果你的模板使用.ejs来定义，那么就无需安装其他 loader 了。当然了，HtmlWebpackPlugin 也提供了许多其它类型的模板可以选择，参见 —— template option。

如果没有为模板文件指定任何 loader，默认使用内置的 loader；
如果在template这个配置项中根据语法为特定的模板文件指定 loader，那么就使用那个指定的 loader；
如果在webpack.config.js中指定相应的 loader 来匹配文件类型，那么就会禁用内置的 loader

接下来新建一个public文件夹，将之前 dist 目录的index.html移入其中，然后把<body>里之前引入的main.js干掉，将这个index.html作为模板页面配置在 HtmlWebpackPlugin 中，然后再把 dist 目录删掉。

const HtmlWebpackPlugin = require("html-webpack-plugin");

module.exports = {
  ...
  plugins: [new HtmlWebpackPlugin({
    template:"./public/index.html"
  })],
}

接下来，需要将 webpack-dev-server 配置里的contentBase删除掉，已经不再需要提供静态文件了，现在依据html-loader和html-webpack-plugin能自动生成一个 html 页面作为 webpack-dev-server 的调试页面了，即使执行生产环境的yarn build命令也能依据靠它们将 html，icon 等静态文件输出到打包目录dist中。

执行yarn start命令，就可以看到自动在浏览器中打开了页面，通过 devtool 也能看到 bundle 文件已经自动插入到指定的 html 中了。

webpack搭建React项目（4）

可以为 html 页面设置一个 favicon，HtmlWebpackPlugin 会根据favicon配置的路径找到文件然后添加到 html 中。

plugins: [
  new HtmlWebpackPlugin({
    template: "./public/index.html",
    favicon: "./public/favicon.ico",
  }),
],

webpack搭建React项目（4）

处理 CSS

style-loader 和 css-loader

在 React 开发过程中如果要使用 CSS，最常见的做法是在当前组件中通过import引入 CSS 文件，但是 CSS 最终需要被放在 HTML 页面中才能被加载，解析。

要将 CSS 自动插入到 html 页面中，需要使用style-loader，光引入style-loader还不行，得需要一个根据import语法解析 CSS 的 css-loader，css-loader负责解析 CSS 文件中的样式生成字符串，然后style-loader默认创建<style>标签塞入 CSS 字符串，最后插入到页面中。

yarn add style-loader css-loader -D

//简单配置
module.exports = {
  ...
  module:{
    rules:[
      ...
      {
        test: /\.css$/i,
        use: [
          {
            loader: "style-loader",
          },
          {
            loader: "css-loader",
          },
        ],
      },
    ]
  }
}

默认是以<style>的形式将组件中引入的 CSS 插入到 DOM 中

webpack搭建React项目（4）

style-loader 配置

配置项	default	含义
`injectType`	`styleTag`	把样式插入到 html 的方式，默认是通过`<style>`标签，可以选择`linkTag`，也就是`<link>`标签	`attributes`	`{}`	写入`<style>`或者`<link>`标签的属性	`insert`	`head`	插入`<style>`或者`<link>`标签的位置，默认就是在 html 的`<head>`中	`base`		`base` 允许你通过指定一个比 DllPlugin1 使用的 css 模块 id 大的值，来避免应用程序中的 css (或者 DllPlugin2 的 css) 被 DllPlugin1 中的 css 覆盖问题	`esModule`	`false`	默认情况下，`style-loader` 生成使用 Common JS 模块语法的 JS 模块；如果指定使用 ES module，有利于 tree shaking

css-loader 配置

配置项	默认值	含义
`url`	`true`	默认启用对`url`/`image-set`动态加载资源的处理	`import`	`true`	默认支持`@import`规则	`modules`	`false`	默认是基于文件名选择是否支持 CSS Modules	`esModule`	`true`	`css-loader` 生成默认使用 ES 模块语法	`importLoaders`	`0`	设置在 CSS 加载程序之前应用的 loader 的数量	`sourceMap`	`false`	取决于 webpack 的`devtool`设置项，只在`devtool`的值不是`eval`和`false`的时候这个配置项才有用

需要特别关注的是modules这个配置，它和CSS Modules相关。因为单页面应用开发中使用 CSS 一个最大的问题就是不好维护，特别容易出现命名混乱，样式覆盖等问题，使用 CSS Modules 可以有效避免这些问题。

css-loader默认是支持 CSS Modules 的，它是根据在 React 中import引入的 CSS 文件名来判断这个 CSS 文件是不是一个模块，如果是就去使用内置的解析规则去替换一些 class 名称等。正则匹配文件名规则是/\.module\.\w+$/i，也就是忽略大小写，文件名中包含.module就被当作一个 CSS 模块。

因此如果你将一个 CSS 文件名命名为xxx.module.css这种形式以后，在 React 组件中使用import引入这个 CSS 文件的时候，必须使用 CSS Modules 指定的规则，也就是把导入的 CSS 看作一个对象，在className中去使用，如下：

/* styles.module.css */
.test {
  color: red;
}

import React, { Component } from 'react';
import styles from './styles.module.css';

export default class extends Component {
  render() {
    return (
      <div>
        <p className={styles.test}>12121212</p>
      </div>
    );
  }
}

webpack搭建React项目（4）

除了使用默认配置， modules可供选择的设置还有这些：

属性值	含义
`true`	全部使用 CSS Modules，设置成这个以后，在 React 中引入 CSS 就必须按照上面那种 CSS Modules 的写法	`false`	禁用 CSS Module	`"local"`	和`true`是一样的，CSS Modules 中的`class`只具有模块作用域	`"global"`	将 CSS Modules 设置成全局作用域	Object Type	`modules`可以设置成一个对象，属性如下表所示，见 —— Object

以modulesObject 形式配置localIdentName 来看，localIdentName 可以指定替换 React 中className的名称，localIdentName 采用loader-utils#interpolatename中的模板字符串替换形式。推荐是开发环境使用"[path][name]__[local]"，生产环境使用"[hash:base64]"，配置一下试试。

modules: {
  localIdentName: isDevelopment
    ? "[path][name]__[local]"
  : "[hash:base64]",
},

开发环境的生成结果：

webpack搭建React项目（4）

yarn build打包的结果：

webpack搭建React项目（4）

postcss-loader

PostCSS是一个开源的用 JS 编写的 CSS 解析器，它能够将 CSS 文件解析成抽象语法树，从而使用 PostCSS 的插件可以基于抽象语法树来转换 CSS 的语法，例如添加浏览器兼容前缀-webkit-（webkit 引擎），-moz-（firefox 的排版引擎）和-ms-（IE 的排版引擎），或者将代码开发阶段使用的未被浏览器广泛支持的 CSS 语法转换成兼容性更强的语法等。例如 CSS 的样式规范工具stylelint就是基于 PostCSS 的。

postcss-loader是让 PostCSS 可以在 webpack 构建工作流中去解析 CSS 生成 AST 的 loader，一般来说是这样的，在 webpack 基于模块间的依赖关系编译完了 JS，CSS，或者 Less 等以后，这些 CSS 文件会被送到 PostCSS 去解析成 AST，然后基于 PostCSS 的插件就可以针对 AST 去干一些有意义的事情，比如说兼容性修改等。

yarn add postcss-loader postcss -D

postcss-loader的配置项是相对简单的，只有三个：

execute：处理 CSS-in-JS 的语法；
postcssOptions：使用 PostCSS 的 options
sourceMap：是否需要生成 source map

module.exports = {
  module: {
    rules: [
      {
        test: /\.css$/i,
        use: [
          'style-loader',
          'css-loader',
          {
            loader: 'postcss-loader',
            options: {
              postcssOptions: {
                //options
              },
            },
          },
        ],
      },
    ],
  },
};

单纯使用postcss-loader没什么卵用，最主要的是引入基于PostCSS 的插件，常用的例如：

autoprefixer：自动给 CSS 属性添加上浏览器供应商的前缀；
postcss-preset-env：对浏览器厂商可能还未实现的 CSS 语法进行转换；
postcss-flexbugs-fixes：修正社区收集的关于flex布局的一些 BUG

yarn add autoprefixer postcss-preset-env postcss-flexbugs-fixes -D

修改上文配置，引入插件

module.exports = {
  module: {
    rules: [
      {
        test: /\.css$/i,
        use: [
          'style-loader',
          'css-loader',
          {
            loader: 'postcss-loader',
            options: {
              postcssOptions: {
                plugins: [
                  'postcss-flexbugs-fixes',
                  'autoprefixer',
                  'postcss-preset-env',
                ],
              },
            },
          },
        ],
      },
    ],
  },
};

现在用::placeholder这个伪元素来测试一下，无论是开发环境还是生产环境都自动添加了厂商前缀，但是autoprefixer在兼容grid布局方面有一些不足，见 —— Does Autoprefixer polyfill Grid Layout for IE，它只能转换到 IE 10 和 IE 11 的程度。

webpack搭建React项目（4）

提取 CSS 文件

生产环境中需要将 React 中import引入的 CSS，或者 less 等导出为单个 CSS 文件，通过<link>标签插入到 DOM 中，推荐使用mini-css-extract-plugin这个 webpack plugin，它可以为每个包含 CSS 的 JS 文件创建一个 CSS 文件，它支持 CSS 和 SourceMap 的按需加载。相比extract-text-webpack-plugin来说，mini-css-extract-plugin特点如下：

异步加载
没有重复的编译
只用于 CSS

yarn add mini-css-extract-plugin -D

修改上文的style-loader配置，同时配置mini-css-extract-plugin内置的 loader 和 plugin

const MiniCssExtractPlugin = require("mini-css-extract-plugin");

module.exports = function (env) {
  const isDevelopment = env.NODE_ENV === "development";
  const isProduction = env.NODE_ENV === "production";
  return {
    ...
    module: {
      rules: [
        ...
        {
          test: /\.css$/i,
          use: [
            isDevelopment && {		//开发环境使用style-loader
              loader: "style-loader",
            },
            isProduction && {			//生产环境使用mini-css-extract-plugin
              loader: MiniCssExtractPlugin.loader,
              options: {
                publicPath: "../../",//因为提取的CSS文件最终位于 static/css文件夹中，所以往上两层
              },
            },
            {
              loader: "css-loader",
              options: {
                modules: {
                  localIdentName: isDevelopment
                    ? "[path][name]__[local]"
                    : "[hash:base64]",
                },
              },
            },
          ].filter(Boolean),
        },
      ],
    },
    plugins: [
      ...
      isProduction &&							//还需要配置启用plugin部分
        new MiniCssExtractPlugin({
          filename: "static/css/[name].[contenthash:8].css",
        }),
      ,
    ].filter(Boolean),
  };
};

执行yarn build看一下输出的文件，已经在dist目录下根据配置的路径生成了 css 文件

webpack搭建React项目（4）

再检查 html 页面，发现 CSS 文件按照路径通过<link>的形式插入

webpack搭建React项目（4）

移除无用的 CSS

移除无用的 CSS 可以使用purgecss，purgecss的文档介绍了很多 plugin 和框架结合的用法，其中我重点关注的是结合 CSS modules 如何使用purgecss —— How to use with CSS modules，这部分内容在purgecss的介绍网站贴出来了，GitHub 的 README 页面并未提及，在 issue 中有一个相关问题 —— Webpack 4 + React + CSS modules stripping all classes from CSS bundle。

根据 issue 中相关讨论，找到了解决方案，见 —— github.com/FullHuman/p…

安装@fullhuman/postcss-purgecss和glob；
在postcss-loader的 plugin 中配置@fullhuman/postcss-purgecss即可

yarn add @fullhuman/postcss-purgecss glob -D

content指定一个文件路径字符串数组，在@fullhuman/postcss-purgecss里是指定代码中通过import引入过 CSS 的地方，指定这些文件路径以后就会去检查它们引入的 CSS 文件中是否包含未使用的 CSS 代码；

glob是一个负责根据通配符匹配文件路径的工具，这里使用glob.sync(pattern, [options])这个方法，去查找所有src目录以及子目录中.jsx结尾的 React 文件。

module.exports = {
  module: {
    rules: [
      {
        test: /\.css$/i,
        use: [
          'style-loader',
          'css-loader',
          {
            loader: 'postcss-loader',
            options: {
              postcssOptions: {
                plugins: [
                  'postcss-flexbugs-fixes',
                  'autoprefixer',
                  'postcss-preset-env',
                  [
                    '@fullhuman/postcss-purgecss', //配置@fullhuman/postcss-purgecss
                    {
                      content: [
                        path.join(__dirname, './public/index.html'),
                        ...glob.sync(
                          `${path.join(__dirname, 'src')}/**/*.jsx`,
                          {
                            nodir: true,
                          },
                        ),
                      ],
                    },
                  ],
                ],
              },
            },
          },
        ],
      },
    ],
  },
};

经过上述配置，现定义一个 button 组件和 CSS 文件，但是只通过 CSS Modules 使用其中一个 CSS 类，执行构建，最终生成的 CSS chunk 确实移除了未使用过的.btn1的代码。

.btn1 {
  background: red;
}

.btn2 {
  background: green;
}

import React, { Component } from "react";
import styles from "./styles.css";

export class Button1 extends Component {
  render() {
    return <button className={styles.btn2}>测试1</button>;
  }
}

webpack搭建React项目（4）

压缩 CSS 代码

mini-css-extract-plugin只负责生成 CSS 文件，要对生产环境打包后的 CSS 文件进行压缩，需要使用额外的插件 —— optimize-css-assets-webpack-plugin。

yarn add optimize-css-assets-webpack-plugin -D

const OptimizeCssAssetsPlugin = require('optimize-css-assets-webpack-plugin'); //压缩CSS代码

module.exports = {
  plugins: [
    new OptimizeCssAssetsPlugin({
      assetNameRegExp: /\.css$/g,
      cssProcessor: require('cssnano'),
      cssProcessorPluginOptions: {
        preset: ['default', { discardComments: { removeAll: true } }],
      },
      canPrint: true,
    }),
  ],
};

assetNameRegExp：匹配需要压缩的 CSS 文件名，默认是/\.css$/g
cssProcessor：压缩 CSS 使用的处理器，默认使用cssnano
cssProcessorOptions：传递给cssProcessor的参数，默认是空对象{}
cssProcessorPluginOptions：传递给cssProcessor的 plugin 选项，默认是空对象{}
canPrint：指示插件是否可以将信息打印到控制台

处理图片

如果在 CSS 中使用url引入一个图片，或者在 React 中直接import一个图片，都需要额外的 loader 来解析图片，webpack 文档中给出了两种 loader 来处理图片资源：file-loader和url-loader。

yarn add file-loader url-loader -D

file-loader

file-loader支持解析 React 中import的图片路径以及在 CSS 中使用url引入的图片，默认情况下，file-loader会对引入的图片重新生成一个 hash 字符串作为替换名称。

module.exports = {
  ...
  modules:{
    rules:[
      ...
      {
        test: [/\.bmp$/, /\.gif$/, /\.jpe?g$/, /\.png$/, /\.svg$/],	//注意不要忘了svg
        loader: "file-loader",
      }
    ]
  }
}

webpack搭建React项目（4）

配置输出目录

如果不对file-loader配置打包后的图片输出目录，在开发环境通常没有影响，但是在执行yarn build以后，图片都会被放在 webpack 的output指定的根目录下面。所以必须为file-loader指定打包后的输出目录。

可以通过name和outputPath指定图片输出目录

module.exports = {
  ...
  modules:{
    rules:[
      ...
      {
        test: [/\.bmp$/, /\.gif$/, /\.jpe?g$/, /\.png$/],
        loader: "file-loader",
        options: {
          name: "[name].[hash:8].[ext]",
          outputPath: "static/images",
        },
      }
    ]
  }
}

这样的配置结果，最终打包输出图片的目录会和 html 在同级目录的static/images下

	├─ dist
    ├─ favicon.ico
    ├─ index.html
    └─ static
      ├─ css
      │	├─ main.css
      └─ images
        └─ picture.jpg

但是这样的打包目录对于在 CSS 中通过url引入的图片来说，它也会被放到static/images目录下，同时路径前缀也是static/images，所以 CSS 就找不到图片了。这种情况我目前找到两种解决方式：

第一种：在之前提取 CSS 的插件mini-css-extract-plugin的 loader 配置中直接指定 CSS 的公共资源目录，这样在打包完了以后，CSS 中引用的资源路径会在static/images前面再加上../../的前缀，这样路径就对了

isProduction && {			//生产环境使用mini-css-extract-plugin
  loader: MiniCssExtractPlugin.loader,
  options: {
    publicPath: '../../',
  },
},

第二种：通过file-loader的name的函数配置方式解决，name的函数会接收三个参数：

resourcePath：原图片的完整路径
resourceQuery：图片路径串接的参数

这种方式我个人想法是对于在 CSS 中引用的图片，设置固定格式的文件名，例如cssimage-xxx.jpg，然后name函数在接收到文件名根据正则表达式去匹配，如果满足是 CSS 中引用的图片文件名格式，那么返回的文件名路径就可以使用特定的形式来指定，例如../../static/images/[name].[hash:8].[ext]，如果不是就使用static/images/[name].[hash:8].[ext]。

url-loader

url-loader是file-loader的升级，对于在limit限制内的小图片，url-loader将图片转成Base64 编码的数据，并通过

Data URLs放在页面中，或者 CSS 中，而对于超过了limit限制的图片，可以指定后续通过file-loader处理，也可以直接为其指定输出路径。

Data URLs

以data://形式开头的 Data URLs 协议是众多 URI 协议中的一种，URI 本身就是统一资源标识符的缩写，所以 Data URLs 也是唯一标识一个资源的形式。

Data URLs 的形式如下：

mediatype，也就是图片的文件类型
;base64这部分字符串时可选的，也就是说你可以直接将某些 mediatype 的文本嵌入到 Data URLs 中，例如 HTML，SVG 等
data，可能是被 Base64 编码以后的数据，也可能是纯文本

通过 Data URLs 协议引入的图片通常如下所示：

webpack搭建React项目（4）

至于 Base64，是使用 ASCII 码中的 64 个可打印字符（a~z，A~Z，0~9以及+和/，最后还有一个=后缀）来编码数据，这种编码的特点是将原数据的每 6 个bit用一个打印字符来表示，也就是一个字符只能表示3/4的数据量，所以经过 Base64 编码的数据，最终会比原始数据大1/3左右。

将 Base64 编码应用在图片上的话，好处有以下这些：

不用在开发时候管那些麻烦的图片路径配置问题；
对于小图片，直接嵌入 HTML 页面或者 CSS 中，节省 HTTP 请求，相当于缩短页面资源在请求过程中的排队时间；
图片直接使用 Base64 编码以后，在 JS 中获取图片可以避免一些跨域使用图片的问题

当然，也有一些局限性：

如果把大图片都转成 Base64 塞到 HTML 或者 CSS 里，会导致页面渲染速度明显减慢，而且还会卡；
浏览器无法针对 Base64 编码的图片单独缓存，要么缓存整个 CSS 或者 HTML 文件；
由于 Base64 上面说的比原图片体积大的问题，需要针对服务器开启gzip压缩传输，这样和原图开启gzip传输基本差不多了

所以一般是推荐一些页面的小图标，小 logo 这些不容易改变，且图片体积小的情况下使用 Base64 编码。

url-loader 配置

url-loader默认是无限制的把所有图片都经 Base64 编码转换，所以必须配置大小限制limit，limit的单位是字节，推荐是10KB以下的图片进行 Base64 编码；对于大于10KB的图片，使用指定文件名的形式来配置。

module.exports = {
  ...
  modules:{
    rules:[
      ...
      {
        test: [/\.bmp$/, /\.gif$/, /\.jpe?g$/, /\.png$/],
        loader: "url-loader",
        options: {
          limit: 10 * 1024,
          name: "static/images/[name].[hash:8].[ext]",
        },
      }
    ]
  }
}

webpack搭建React项目（4）

处理 SVG

SVG 模块

SVG 一般在网页中可以通过三种方式使用：

直接使用<svg>标签嵌入 HTML
import以后放在<img>中加载
通过 CSS 的url引入

开发的时候，一般不会选择第一种方式，不好看也不利于维护。所以一般是做成模块，通过<img>或者url形式去引入。所以在上面的配置中，还需要添加一种 SVG 的文件格式匹配/\.svg$/i。

单个的 SVG 文件一般都比较小，如果按照上面的url-loader配置，SVG 一般会被转成 Base64 然后通过 Data URLs 放在<img>或者url里面，但是 SVG 本身是可以直接放在 Data URLs 里的，如果转成 Base64 以后再放进去，数据量变大了1/3，徒增 HTML 或者 CSS 文件的体积，这是反向优化！所以不可取，对 SVG 需要额外的处理。

url-loader是推荐了一个mini-svg-data-uri来处理 SVG，这个工具可以移除原 SVG 文件中注释，空格等乱七八糟没用的字符，同时会对 SVG 中的字符进行 URL 编码，避免一些旧的 IE 上不兼容的问题，然后再通过url-loader被放在 Data URLs 里。

yarn add mini-svg-data-uri -D

const svgToMiniDataURI = require('mini-svg-data-uri');

module.exports = {
  module: {
    rules: [
      ...{
        test: /\.svg$/i,
        use: [
          {
            loader: 'url-loader',
            options: {
              generator: content => svgToMiniDataURI(content.toString()),
            },
          },
        ],
      },
    ],
  },
};

import logo from 'logo.svg';

export default class extends Component {
  render() {
    return <img src={logo} />;
  }
}

webpack搭建React项目（4）

SVG 组件

如果想直接在页面里使用这个 SVG 图片，而不是放在<img>标签里，可以使用 airbnb 出品的babel-plugin-inline-react-svg，这个插件我在测试的时候，会和上面的url-loader有一定的冲突。它提供的功能是：

将 SVG 文件转换成 React 组件
使用SVGO优化压缩 SVG

yarn add babel-plugin-inline-react-svg -D

module.exports = {
  module: {
    rules: [
      {
        test: /\.m?jsx?$/,
        exclude: /(node_modules)/,
        use: {
          loader: "babel-loader",
          options: {
            presets: ["@babel/preset-env", "@babel/preset-react"],
            plugins: [
              "@babel/plugin-proposal-class-properties",
              "inline-react-svg",		//注意到这是一个babel的plugin引入
          ].filter(Boolean),
        },
     },
     ...
  }
}

测试一下，SVG 可以通过组件的方式被插入到页面中了。

import Logo from 'logo.svg';

export default class extends Component {
  render() {
    return <Logo />;
  }
}

webpack搭建React项目（4）

而当我在项目配置resolve.alias的时候，想用 alias 去引入一个 SVG 组件时，babel-plugin-inline-react-svg不支持 alias 解析，一直报错。

import View from '@/assets/icons/view.svg';

webpack搭建React项目（4）

我在babel-plugin-inline-react-svg的 issue 也提了这个问题，插件作者回复是因为 babel 在 webpack 应用 alias 之前已经开始运行了。后来找到了两个解决方法：

一是安装babel-plugin-module-resolver，这个是 babel 的 plugin，帮助 babel 解析 alias 路径问题，配合babel-plugin-inline-react-svg使用。

yarn add babel-plugin-module-resolver -D

module.exports = {
  module: {
    rules: [
      {
        test: /\.m?jsx?$/,
        exclude: /(node_modules)/,
        use: {
          loader: "babel-loader",
          options: {
            presets: ["@babel/preset-env", "@babel/preset-react"],
            plugins: [
              "@babel/plugin-proposal-class-properties",
              "inline-react-svg",	        // apply babel-plugin-inline-react-svg
              [
                "module-resolver",         //  apply babel-plugin-module-resolver
                {
                  alias: {
                    "@": "./src",
                  },
                },
              ],
            ],
          },
        },
        ...
      }

另一个解决方式是换成@svgr/webpack 这个 webpack loader 来解析 SVG 组件。

yarn add @svgr/webpack -D

module.exports = {
  module: {
    rules: [
      {
        test: /\.svg$/,
        use: [
          {
            loader: '@svgr/webpack',
            options: {
              native: true,
            },
          },
        ],
      },
    ],
  },
};

svg-sprite

上面的 SVG 方案都是一次引入一个 SVG 图像，这种方式在页面图标多的时候非常麻烦，20 多个图标都得 20 个import。

SVG sprite 是利用和以前 CSS sprite 相同的方案思路，将多个 SVG 图像合并到一个 SVG 文件中，最终在页面中只显示一个特定 SVG 图像。SVG sprite 只适合多个小的 SVG 图标整合，对于大的 SVG 图像当作普通图片用上面的方法处理比较合适。

经过一定的 webpack 配置，在 React 中可以直接使用 SVG sprite，方法是先将所有 SVG 图像在项目外面合成一个 SVG spritesprite.svg，内容如下：

<svg width="0" height="0" class="hidden">
  <symbol viewBox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" id="view">
    <path
      d="M512 608a96 96 0 1 1 0-192 96 96 0 0 1 0 192m0-256c-88.224 0-160 71.776-160 160s71.776 160 160 160 160-71.776 160-160-71.776-160-160-160"
    ></path>
    <path
      d="M512 800c-212.064 0-384-256-384-288s171.936-288 384-288 384 256 384 288-171.936 288-384 288m0-640C265.248 160 64 443.008 64 512c0 68.992 201.248 352 448 352s448-283.008 448-352c0-68.992-201.248-352-448-352"
    ></path>
  </symbol>
  <symbol
    viewBox="0 0 1024 1024"
    xmlns="http://www.w3.org/2000/svg"
    id="view_off"
  >
    <path
      d="M512 800c-66.112 0-128.32-24.896-182.656-60.096l94.976-94.976A156.256 156.256 0 0 0 512 672c88.224 0 160-71.776 160-160a156.256 156.256 0 0 0-27.072-87.68l101.536-101.536C837.28 398.624 896 493.344 896 512c0 32-171.936 288-384 288m96-288a96 96 0 0 1-96 96c-14.784 0-28.64-3.616-41.088-9.664l127.424-127.424C604.384 483.36 608 497.216 608 512m-480 0c0-32 171.936-288 384-288 66.112 0 128.32 24.896 182.656 60.096l-417.12 417.12C186.72 625.376 128 530.656 128 512m664.064-234.816l91.328-91.328-45.248-45.248-97.632 97.632C673.472 192.704 595.456 160 512 160 265.248 160 64 443.008 64 512c0 39.392 65.728 148.416 167.936 234.816l-91.328 91.328 45.248 45.248 97.632-97.632C350.528 831.296 428.544 864 512 864c246.752 0 448-283.008 448-352 0-39.392-65.728-148.416-167.936-234.816"
    ></path>
    <path
      d="M512 352c-88.224 0-160 71.776-160 160 0 15.328 2.848 29.856 6.88 43.872l58.592-58.592a95.616 95.616 0 0 1 79.808-79.808l58.592-58.592A157.76 157.76 0 0 0 512 352"
    ></path>
  </symbol>
</svg>

然后很关键的，这是一个静态文件，我的做法是把它直接和 HTML 页面放在一个文件夹下，也就是都放在直接建的public里面。在开发环境下，需要在 WDS 里面通过contentBase配置静态文件的目录，表示服务器在请求的时候要带上这些静态文件，如下：

module.exports = {
  ...
  devServer:{
    ...
    contentBase: "public",
  }
}

这时候就可以直接在 React 里面通过<use>使用上面sprite.svg里的任意一个图标了，还能通过fill，height或者width等属性修改图标。注意两点：

这里的使用不需要import去导入sprite.svg
注意<use>的href的路径，永远是相对于当前 HTML 页面所在的目录，这样即使打包以后也能找得到

export default class extends Component {
  render() {
    return (
      <div>
        <svg>
          <use href="sprite.svg#view" fill="red" />
        </svg>
        <svg>
          <use href="sprite.svg#view_off" />
        </svg>
      </div>
    );
  }
}

webpack搭建React项目（4）

如果要执行打包yarn build，需要借助一个 webpack 的插件 —— copy-webpack-plugin，这个插件可以将指定目录的文件复制到另一个目录中，并且复制过程还可以借助一些工具来压缩文件，例如可以使用SVGO的工具来优化 SVG 文件

yarn add copy-webpack-plugin -D

const CopyPlugin = require('copy-webpack-plugin');

module.exports = {
  plugins: [
    new CopyPlugin({
      patterns: [{ from: 'public/sprite.svg' }], //将sprite.svg复制到打包输出目录
    }),
  ],
};

这种方式十分简单，并且能节省 SVG 文件的请求；但是不利于维护，图标更新需要手动修改文件，必须保证每个 SVG 图标的 id 是唯一的，图标越来越多的情况下，很乱，同时无法按需加载，页面只要包含一个图标文件，整个sprite.svg都会被请求加载。

svg-sprite-loader

解决按需加载和方便维护的一个方法是使用 JetBrains 出品的svg-sprite-loader，它可以在运行的时候根据组件中引入的 SVG 文件，动态地将这些文件合并成sprite.svg，然后插入到 HTML 中，测试一下：

首先，在项目中新建一个专门用来放图标的文件夹src/assets/icons，普通的 SVG 图像就不要放进去了，专门用来管理图标的。

把刚才那两个合成sprite.svg的图标分开放进去，于是有了下面的目录结构：

src
├─ assets
│    ├─ icons
│    │    ├─ view.svg
│    │    └─ view_off.svg
│    ├─ images
│    │    ├─ picture.svg

在 webpack 中引入svg-sprite-loader并配置，需要注意的是使用 webpack 的include和exclude对不同用处的 SVG 进行区分：

url-loader处理页面中通过<img>或者在 CSS 中通过url引入的 SVG，要忽略掉src/assets/icons
babel-plugin-inline-react-svg负责处理组件形式的 SVG，无关
svg-sprite-loader负责处理组件中以<svg>标签直接嵌入的形式，只处理src/assets/icons

yarn add svg-sprite-loader -D

module.exports = {
  module: {
    rules: [
      ...{
        oneOf: [
          {
            test: /\.svg$/i,
            exclude: path.resolve(__dirname, 'src/assets/icons'), //忽略icon文件夹
            use: [
              {
                loader: 'url-loader',
              },
            ],
          },
          {
            test: /\.svg$/i,
            include: path.resolve(__dirname, 'src/assets/icons'), //只处理icon文件夹
            use: 'svg-sprite-loader',
          },
        ],
      },
    ],
  },
};

这样在组件中importSVG 文件以后，能直接通过<use>使用图标：

import '../../assets/icons/view.svg';

export default class extends Component {
  render() {
    return (
      <div>
        <svg>
          <use href="#view" />
        </svg>
      </div>
    );
  }
}

webpack搭建React项目（4）

图片压缩

image-webpack-loader是使用imagemin进行图片压缩的 loader，可以在url-loader或者file-loader的基础上进行图片压缩。

yarn add image-webpack-loader -D

// 在url-loader的基础上使用
module.exports = function(env) {
  const isDevelopment = env.NODE_ENV === 'development';
  return {
    module: {
      rules: [
        {
          test: [/\.bmp$/, /\.gif$/, /\.jpe?g$/, /\.png$/, /\.svg$/i],
          include: path.resolve(__dirname, 'src/assets/images'),
          use: [
            {
              loader: 'url-loader',
              options: {
                limit: 10 * 1024, //10KB
                name: 'static/images/[name].[hash:8].[ext]',
              },
            },
            {
              loader: 'image-webpack-loader', //引入image-webpack-loader
              options: {
                disable: isDevelopment, // webpack@2.x and newer
              },
            },
          ],
        },
      ],
    },
  };
};

默认配置情况下，对图片的压缩可以减少约60%的图片体积，可以看到压缩前图片7.39MB，压缩后仅为2.32MB

webpack搭建React项目（4）

需要注意的是，本身压缩图片是一件缓慢的事，我在上面一张图片的压缩大概耗费了 6s 的时间呢，所以指定disable: isDevelopment在开发环境下会禁用image-webpack-loader。

webpack搭建React项目（4）

处理字体

一般情况下，字体文件可以用作文本的渲染，或者用来处理 IconFont，即通过@font-face定义 IconFont，然后在 CSS 使用@font-face定义的图标。

file-loader和url-loader都能用来处理字体文件，如果通过 CSS 的@font-face中的src来引入 web 字体，例如加载服务器上的字体文件，那么需要 loader 来处理。

以配置使用url-loader为例：

module.exports = {
  ...
  module: {
    rules:[
      ...
      {
        test: [/\.ttf/i, /\.woff/i, /\.woff2/i, /\.eot/i, /\.otf/i],
        loader: "url-loader",
        include: path.resolve(__dirname, "src/assets/fonts"),
        options: {
          limit: 10 * 1024, //10KB
          name: "static/fonts/[name].[hash:8].[ext]",
        },
      },
    ]
  }
}

这样就可以使用@font-face的url加载服务器上的字体文件了

@font-face {
  font-family: 'heiti2';
  src: url('../../assets/fonts/heiti2.ttf');
}

body {
  font-family: 'heiti2';
}

字体压缩

一般中文字体包包含大量的中文字符，导致中文字体包一般都非常的大，随便一个都可能都是几MB，如果网页全局使用字体包中的字体，会影响网页的呈现速度。

在引入字体之前对字体包进行压缩是一个解决方案，这里使用开源工具字蛛，使用 font-spider，首先新建一个空文件夹，内部新建一个 html 文件，并且将原字体包放在里面，如下：

<!DOCTYPE html>
<html lang="zh-hans">
  <head>
    <meta charset="utf-8" />
    <style>
      @font-face {
        font-family: 'heiti2';
        src: url('./heiti2.ttf');
      }

      body {
        font-family: 'heiti2';
      }
    </style>
  </head>
</html>

然后安装font-spider

yarn global add font-spider

进入刚才新建的 html 文件的目录，开始执行压缩命令

font-spider ./index.html

执行完以后，目录下面会生成一个备份目录.font-spider用来保存原字体文件，而原来的字体文件已经被替换成了压缩以后的字体文件，这个压缩效果，目录结构如下：

minify
├─ .font-spider
│    └─ heiti2.ttf
├─ heiti2.ttf
├─ index.html

这个压缩效果还是十分强悍的，经过测试，原字体文件2.17MB，压缩以后只有6KB了。不过需要注意的是，这里的压缩只是一个测试，在 webpack 中使用的话，目前 font-spider 没有相应的方案，这个项目已经很久没维护了，见讨论 —— 如何在 webpack 中使用本工具 #150。如果想 webpack 配套使用，需要在打包以后，额外执行一下font-spider压缩命令，然后可能还需要检查一下字体引用路径是否正确。

管理模块

module

处理 HTML

HtmlWebpackPlugin

配置项

模板配置

处理 CSS

style-loader 和 css-loader

style-loader 配置

css-loader 配置

postcss-loader

提取 CSS 文件

移除无用的 CSS

压缩 CSS 代码

处理图片

file-loader

配置输出目录

url-loader

Data URLs

url-loader 配置

处理 SVG

SVG 模块

SVG 组件

svg-sprite

svg-sprite-loader

图片压缩

处理字体

字体压缩

常见问题FAQ

掘金(0²) SVIP

发表评论

如需帝国cms功能定制以及二次开发请联系我们

升级SVIP会员

工作时间

管理模块

module

处理 HTML

HtmlWebpackPlugin

配置项

模板配置

处理 CSS

style-loader 和 css-loader

style-loader 配置

css-loader 配置

postcss-loader

提取 CSS 文件

移除无用的 CSS

压缩 CSS 代码

处理图片

file-loader

配置输出目录

url-loader

Data URLs

url-loader 配置

处理 SVG

SVG 模块

SVG 组件

svg-sprite

svg-sprite-loader

图片压缩

处理字体

字体压缩

常见问题FAQ

掘金(0²) SVIP

相关推荐

发表评论

如需帝国cms功能定制以及二次开发请联系我们

升级SVIP会员

工作时间

请选择支付方式