目录

  • 资源管理

  •     webpack 的优势

  •     Loader

  •         安装加载器

  •         配置 Loader

  •         引用资源文件

  •     Plugin

  •         安装插件

  •         配置 Plugin

  •     加载资源专题

  •         加载 React

  •         加载 CSS

  •         加载图片

  •         压缩图片

  •         加载字体

  • Webpack 系列教程

回到顶部

资源管理

 提示:

  1. 版本问题

本文基于 webpack 2.x 版本。webpack 2.x 相比 webpack 1.x 有重大改变。所以,如果你的项目中已使用了 webpack 1.x ,本教程的示例将不适用,请慎重。

如果铁了心要升级 webpack ,请参考 webpack 官方文档 - 从 v1 迁移到 v2

  1. 阅读建议

阅读本文前,建议先阅读 Webpack 概念 。

webpack 的优势

webpack 最重要的功能就是资源管理。

JavaScript 世界已有好几个有名的资源管理工具,webpack 有什么独到之处呢?

在 webpack 出现之前,前端开发人员会使用 grunt 和 gulp 等工具来处理这些 web 资源,如样式文件(例如 .css.less.sass),图片(例如 .png.jpg.svg),字体(例如 .woff.woff2.eot)和数据(例如 .json.xml.csv)等,并将它们从 /src 文件夹移动到 /dist 或 /build 目录中。

而 webpack 从 entry(入口) 开始,访问应用程序,并动态打包(dynamically bundle)所有依赖项。这是极好的创举,因为现在每个模块都可以明确表述它自身的依赖,这可以避免打包未使用的模块。

Loader

Loader(加载器) 用于对模块的源代码进行转换。

使用加载器一般遵循几步:

  1. 安装加载器

  2. 配置 Loader

  3. 引用资源文件

安装加载器

根据需要加载的资源文件,选择下载对应的加载器。

$ npm install --save-dev css-loader

更多 webpack 可用Loader 请查看:webpack loaders

配置 Loader

 注意:

webpack 2.x 版本的 Loader 配置和 webpack 1.x 版本差别很大。

Loader 在 webpack.config.js 文件的 module 属性中配置。

资源类型对应单一加载器

module: {
  rules: [    {test: /\.css$/, loader: 'css-loader'}
  ]},

资源类型对应多个加载器

module: {
  rules: [    {
      test: /\.css$/,
      use: ["style-loader", "css-loader"]    }
  ]},

加载器含配置选项

module: {
  rules: [    {
      test: /\.css$/,
      use: [        { loader: 'style-loader' },
        {
          loader: 'css-loader',
          options: {
            modules: true
          }
        }
      ]    }
  ]},

引用资源文件

完成上两步后,就可以在 JavaScript 中使用 import ,require 关键字引用相应类型资源文件。

import './index.css';require('./index.css');

Plugin

Plugin(插件) 用于解决 Loader 无法解决的问题,它是 Loader 的辅助。

由于 plugin 可以携带参数/选项,你必须在 wepback 配置中,向 plugins 属性传入 new 实例。

安装插件

webpack 自身包含了一些常用插件,你可以通过 webpack 来引用。除此之外的插件,使用前需要安装

$ npm install --save-dev html-webpack-plugin OpenBrowserPlugin

更多 webpack Plugins 可以查看: webpack plugins

配置 Plugin

const webpack = require('webpack');const HtmlWebpackPlugin = require('html-webpack-plugin');const OpenBrowserPlugin = require('open-browser-webpack-plugin');module.exports = {
  // 附加插件列表
  plugins: [    // 压缩 js 插件
    new webpack.optimize.UglifyJsPlugin({
      compress: {
        warnings: false
      }
    }),

    // 用于简化 HTML 文件(index.html)的创建,提供访问 bundle 的服务。
    new HtmlWebpackPlugin({
      title: "react-step-by-step",
      template: "./index.html"
    }),

    // 自动打开浏览器
    new OpenBrowserPlugin({
      url: "http://localhost:8080"
    })
  ]};

加载资源专题

加载 React

很多浏览器并不识别 React 语法,为了让浏览器支持,你需要使用 babel-loader 解释器来转义 React 语法为普通的 Javascript 语法。

 注意:

官方推荐 babel-loader 和 webpack 的对应版本

webpack 1.x | babel-loader <= 6.x

webpack 2.x | babel-loader >= 7.x (推荐)(^6.2.10 也可以运行,但会有不赞成的警告(deprecation warnings))

首先,安装需要使用的库:

$ npm install --save-dev babel-loader babel-preset-es2015 babel-preset-react

babel-preset-xxx 表示你希望转义的语法。

webpack.config.js 中的模块配置如下:

// 关于模块配置module: {

  // 模块规则(配置 loader、解析器等选项)
  rules: [    // 这里是匹配条件,每个选项都接收一个正则表达式或字符串
    // test 和 include 具有相同的作用,都是必须匹配选项
    // exclude 是必不匹配选项(优先于 test 和 include)
    // 最佳实践:
    // - 只在 test 和 文件名匹配 中使用正则表达式
    // - 在 include 和 exclude 中使用绝对路径数组
    // - 尽量避免 exclude,更倾向于使用 include
    {
      // 语义解释器,将 js/jsx 文件中的 es2015/react 语法自动转为浏览器可识别的 Javascript 语法
      test: /\.jsx?$/,
      include: path.resolve(__dirname, "app"),

      // 应该应用的 loader,它相对上下文解析
      // 为了更清晰,`-loader` 后缀在 webpack 2 中不再是可选的
      // 查看 webpack 1 升级指南。
      loader: "babel-loader",

      // loader 的可选项
      options: {
        presets: ["es2015", "react"]      },
    },
  ]},

 示例DEMO04: (DEMO / SOURCE)

加载 CSS

为了从 JavaScript 模块中 import 一个 CSS 文件,你只需要在 module 中安装并添加 style-loader 和 css-loader 。

$ npm install --save-dev style-loader css-loader

webpack.config.js

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

好了,此时你就可以在代码中通过 import './style.css' 的方式引入 CSS 文件。

其余,加载 less,sass 等样式文件也是大同小异,不一一细说。

 示例DEMO06: (DEMO / SOURCE)

加载图片

如何打包、加载图片呢?你可以使用 file-loader来指定要加载的图片。

$ npm install --save-dev file-loader

webpack.config.js

module.exports = {
  //...
  module: {
    rules: [      {
        test: /\.(png|svg|jpg|gif)$/,
        use: [          'file-loader'
        ]      }
    ]  },
  //...}

然后,你可以通过 import imgBig from './lion.png' 的方式引入图片。例:

import React from 'react';import imgBig from './lion.png';class Welcome extends React.PureComponent {
  render() {    return (
      
        

Hello, {this.props.name}

               
    );   } } export default Welcome;

压缩图片

这还不算完,日常开发中,经常会遇到有些图片文件过大的问题,这会影响你的 app 的加载速度。webpack 提供了压缩图片的方法帮你解决图片大的问题。

首先,你需要安装 p_w_picpath-webpack-loader

$ npm i --save-dev p_w_picpath-webpack-loader

接下来,修改 webpack.config.js

{
  // 图片加载 + 图片压缩
  test: /\.(png|svg|jpg|gif)$/,
  loaders: [    "file-loader",
    {
      loader: "p_w_picpath-webpack-loader",
      query: {
        progressive: true,
        pngquant: {
          quality: "65-90",
          speed: 4
        }
      }
    }
  ]}

 示例DEMO07: (DEMO / SOURCE)

加载字体

那么,像字体这样的其他资源如何处理呢?file-loader 和 url-loader 可以接收并加载任何文件,然后将其输出到构建目录。这就是说,我们可以将它们用于任何类型的文件,包括字体:

webpack.config.js

module.exports = {
  //...
  module: {
    rules: [      {
        test: /\.(woff|woff2|eot|ttf|svg)$/,
        use: [          'file-loader'
        ]      }
    ]  },
  //...}

一切就绪后,你可以在 css 文件中这样引入字体:

@font-face {
  font-family: 'MyDiyFont';
  src: url('./font/iconfont.eot'); /* IE9*/
  src: url('./font/iconfont.eot?#iefix') format('embedded-opentype'), /* IE6-IE8 */
  url('./font/iconfont.woff') format('woff'), /* chrome、firefox */
  url('./font/iconfont.ttf') format('truetype'), /* chrome、firefox、opera、Safari, Android, iOS 4.2+*/
  url('./font/iconfont.svg#iconfont') format('svg'); /* iOS 4.1- */}h1 {
  font-family: 'MyDiyFont';
  font-size: 24px;}p {
  font-family: 'MyDiyFont';
  font-size: 18px;}

然后,相对路径,会被替换为构建目录中的完整路径/文件名。

 示例DEMO08: (DEMO / SOURCE)