extract-text-webpack-plugin用法

一 背景
最近在做一个项目,项目本身是用vue-cli创建的单页面应用,由于项目扩展需要创建多页面,所以需要对不同的html分别进行css文件打包。于是开始研究extract-text-webpack-plugin插件。
二 插件介绍
打包样式有两种方法,一种是使用style-loader自动将css代码放到生成的style标签中,并且插入到head标签里。另一种就是使用extract-text-webpack-plugin插件,将样式文件单独打包,打包输出的文件由配置文件中的output属性指定。然后我们在入口HTML页面写个link标签引入这个打包后的样式文件。
三 插件使用
1 插件安装:

# for webpack 3 
npm install --save-dev extract-text-webpack-plugin
# for webpack 2 
npm install --save-dev extract-text-webpack-plugin@2.1.2
# for webpack 1 
npm install --save-dev extract-text-webpack-plugin@1.0.1

2 插件使用
在webpack.config.js中引入

const ExtractTextPlugin = require("extract-text-webpack-plugin");

module.exports = {
  module: {
    rules: [
      {
        test: /\.css$/,
        use: ExtractTextPlugin.extract({
          fallback: "style-loader", // 编译后用什么loader来提取css文件
          use: "css-loader" // 指需要什么样的loader去编译文件,这里由于源文件是.css所以选择css-loader
        })
      }
    ]
  },
  plugins: [
    new ExtractTextPlugin("styles.css"),
  ]
}

四 API

new ExtractTextPlugin([id: string], filename: string, [options])

  1. id此插件实例的唯一标识。(仅限高级用法;默认情况下,自动生成)
  2. filename结果文件的文件名。可能包含[name],[id]和[contenthash]。
    [name] 块的名称
    [id] 块的标识
    [contenthash] 提取文件内容的哈希值
  3. options
  • allChunks 从所有其他块中提取(默认情况下,它仅从初始块中提取)
  • disable 禁用插件

ExtractTextPlugin.extract([notExtractLoader], loader, [options]
从现有加载器创建提取加载器。

  1. notExtractLoader(可选)在未提取css时应使用的加载程序(即在其他块中时allChunks: false)
  2. loader 应该用于将资源转换为css导出模块的加载器。
  3. options
    publicPath覆盖publicPath此加载程序的设置。

五 扩展
该实例其实还有一个扩展函数。如果你有多个ExtractTextPlugin,你应该使用它。

let ExtractTextPlugin = require('extract-text-webpack-plugin');

// multiple extract instances
let extractCSS = new ExtractTextPlugin('stylesheets/[name].css');
let extractLESS = new ExtractTextPlugin('stylesheets/[name].less');

module.exports = {
  ...
  module: {
    loaders: [
      {test: /\.scss$/i, loader: extractCSS.extract(['css','sass'])},
      {test: /\.less$/i, loader: extractLESS.extract(['css','less'])},
      ...
    ]
  },
  plugins: [
    extractCSS,
    extractLESS
  ]
};
要使用 `extract-text-webpack-plugin` 插件,你需要先安装它。在安装之前,确保你已经安装了 Node.js 和 npm。 安装 `extract-text-webpack-plugin` 的命令如下: ``` npm install --save-dev extract-text-webpack-plugin ``` 安装完成后,在 webpack 的配置文件中引入插件: ```javascript const ExtractTextPlugin = require('extract-text-webpack-plugin'); ``` 然后在 `module.rules` 中配置插件的规则: ```javascript module.exports = { // ...其它配置项... module: { rules: [ // ...其它规则... { test: /\.css$/, use: ExtractTextPlugin.extract({ fallback: 'style-loader', use: ['css-loader'] }) } ] }, plugins: [ new ExtractTextPlugin('styles.css') ] }; ``` 在上面的代码中,我们将 `ExtractTextPlugin` 实例化并传入一个输出文件名,然后在 `module.rules` 中的 CSS 规则中使用 `ExtractTextPlugin.extract()` 方法来提取 CSS 到单独文件中。注意,我们同时使用了 `style-loader` 和 `css-loader`,这是因为 `ExtractTextPlugin.extract()` 方法要求至少有一个 loader 是非提取 loader(即不会将文件输出到文件系统中),这里我们使用了 `style-loader` 来将 CSS 插入到 HTML 文档中。 以上代码中,我们还需要在 webpack 配置文件的 `plugins` 中添加 `new ExtractTextPlugin('styles.css')`,这个插件将会在构建时将 CSS 提取到指定的输出文件中。 最后,运行 webpack 构建命令,就能够将 CSS 提取到单独的文件中了。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值