目录
资源管理
webpack 的优势
Loader
安装加载器
配置 Loader
引用资源文件
Plugin
安装插件
配置 Plugin
加载资源专题
加载 React
加载 CSS
加载图片
压缩图片
加载字体
Webpack 系列教程
回到顶部
资源管理
提示:
版本问题
本文基于
webpack 2.x
版本。webpack 2.x
相比webpack 1.x
有重大改变。所以,如果你的项目中已使用了 webpack 1.x ,本教程的示例将不适用,请慎重。如果铁了心要升级 webpack ,请参考 webpack 官方文档 - 从 v1 迁移到 v2
阅读建议
阅读本文前,建议先阅读 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(加载器)
用于对模块的源代码进行转换。
使用加载器一般遵循几步:
安装加载器
配置 Loader
引用资源文件
安装加载器
根据需要加载的资源文件,选择下载对应的加载器。
$ 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 (); } } export default Welcome;Hello, {this.props.name}
压缩图片
这还不算完,日常开发中,经常会遇到有些图片文件过大的问题,这会影响你的 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)