Webpack 资源管理

资源管理

:pushpin: 提示:

  1. 版本问题

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

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

  1. 阅读建议

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

webpack 的优势

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

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

webpack 出现之前,前端开发人员会使用 gruntgulp 等工具来处理这些 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

​:warning: 注意:

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 中使用 importrequire 关键字引用相应类型资源文件。

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 语法。

:warning: 注意:

官方推荐 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"]
      },
    },
  ]
},

​:flashlight:​ 示例DEMO04: (DEMO / SOURCE)

加载 CSS

为了从 JavaScript 模块中 import 一个 CSS 文件,你只需要在 module 中安装并添加 style-loadercss-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 等样式文件也是大同小异,不一一细说。

:flashlight: 示例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 (
      <div>
        <h1>Hello, {this.props.name}</h1>
        <img src={imgBig} />
      </div>
    );
  }
}
export default Welcome;

压缩图片

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

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

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

接下来,修改 webpack.config.js

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

:flashlight: 示例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;
}

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

:flashlight: 示例DEMO08: (DEMO / SOURCE)

Webpack 系列教程

欢迎阅读其它内容:

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,056评论 5 474
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,842评论 2 378
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 148,938评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,296评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,292评论 5 363
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,413评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,824评论 3 393
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,493评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,686评论 1 295
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,502评论 2 318
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,553评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,281评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,820评论 3 305
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,873评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,109评论 1 258
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,699评论 2 348
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,257评论 2 341

推荐阅读更多精彩内容