ExtractTextWebpackPlugin

Extract text from a bundle, or bundles, into a separate file.

安装

  1. npm install --save-dev extract-text-webpack-plugin
  2. # 对于 webpack 2
  3. npm install --save-dev extract-text-webpack-plugin@2.1.2
  4. # 对于 webpack 1
  5. npm install --save-dev extract-text-webpack-plugin@1.0.1

用法

:warning: Since webpack v4 the extract-text-webpack-plugin should not be used for css. Use mini-css-extract-plugin instead.

:warning: 对于 webpack v1, 请看 分支为 webpack-1 的 README 文档

  1. const ExtractTextPlugin = require("extract-text-webpack-plugin");
  2. module.exports = {
  3. module: {
  4. rules: [
  5. {
  6. test: /\.css$/,
  7. use: ExtractTextPlugin.extract({
  8. fallback: "style-loader",
  9. use: "css-loader"
  10. })
  11. }
  12. ]
  13. },
  14. plugins: [
  15. new ExtractTextPlugin("styles.css"),
  16. ]
  17. }

它会将所有的入口 chunk(entry chunks)中引用的 *.css,移动到独立分离的 CSS 文件。因此,你的样式将不再内嵌到 JS bundle 中,而是会放到一个单独的 CSS 文件(即 styles.css)当中。 如果你的样式文件大小较大,这会做更快提前加载,因为 CSS bundle 会跟 JS bundle 并行加载。

优点

缺点

优点

更少 style 标签 (旧版本的 IE 浏览器有限制)

缺点

额外的 HTTP 请求

优点

CSS SourceMap (使用 devtool: "source-map"extract-text-webpack-plugin?sourceMap 配置)

缺点

更长的编译时间

优点

CSS 请求并行

缺点

没有运行时(runtime)的公共路径修改

优点

CSS 单独缓存

缺点

没有热替换

优点

更快的浏览器运行时(runtime) (更少代码和 DOM 操作)

缺点

选项

  1. new ExtractTextPlugin(options: filename | object)

名称

类型

描述

名称

id

类型

{String}

描述

此插件实例的唯一 ident。(仅限高级用途,默认情况下自动生成)

名称

filename

类型

{String|Function}

描述

生成文件的文件名。可能包含 [name], [id] and [contenthash]

名称

allChunks

类型

{Boolean}

描述

从所有额外的 chunk(additional chunk) 提取(默认情况下,它仅从初始chunk(initial chunk) 中提取)
当使用 CommonsChunkPlugin 并且在公共 chunk 中有提取的 chunk(来自ExtractTextPlugin.extract)时,allChunks **必须设置为 true

名称

disable

类型

{Boolean}

描述

禁用插件

名称

ignoreOrder

类型

{Boolean}

描述

禁用顺序检查 (这对 CSS 模块很有用!),默认 false

  • [name] chunk 的名称
  • [id] chunk 的数量
  • [contenthash] 根据提取文件的内容生成的 hash
  • [<hashType>:contenthash:<digestType>:<length>] optionally you can configure
    • other hashTypes, e.g. sha1, md5, sha256, sha512
    • other digestTypes, e.g. hex, base26, base32, base36, base49, base52, base58, base62, base64
    • and length, the length of the hash in chars

:警告: ExtractTextPlugin每个入口 chunk 都生成一个对应的文件,所以当你配置多个入口 chunk 的时候,你必须使用 [name], [id][contenthash]

#extract

  1. ExtractTextPlugin.extract(options: loader | object)

从一个已存在的 loader 中,创建一个提取(extract) loader。支持的 loader 类型 { loader: [name]-loader -> {String}, options: {} -> {Object} }

名称

类型

描述

名称

options.use

类型

{String}/{Array}/{Object}

描述

loader 被用于将资源转换成一个 CSS 导出模块 (必填)

名称

options.fallback

类型

{String}/{Array}/{Object}

描述

loader(例如 'style-loader')应用于当 CSS 没有被提取(也就是一个额外的 chunk,当 allChunks: false)

名称

options.publicPath

类型

{String}

描述

重写此 loader 的 publicPath 配置

多个实例

如果有多于一个 ExtractTextPlugin 示例的情形,请使用此方法每个实例上的 extract 方法。

  1. const ExtractTextPlugin = require('extract-text-webpack-plugin');
  2. // 创建多个实例
  3. const extractCSS = new ExtractTextPlugin('stylesheets/[name]-one.css');
  4. const extractLESS = new ExtractTextPlugin('stylesheets/[name]-two.css');
  5. module.exports = {
  6. module: {
  7. rules: [
  8. {
  9. test: /\.css$/,
  10. use: extractCSS.extract([ 'css-loader', 'postcss-loader' ])
  11. },
  12. {
  13. test: /\.less$/i,
  14. use: extractLESS.extract([ 'css-loader', 'less-loader' ])
  15. },
  16. ]
  17. },
  18. plugins: [
  19. extractCSS,
  20. extractLESS
  21. ]
  22. };

提取 Sass 或 LESS

配置和上面是相同的,需要时可以将 sass-loader 切换为 less-loader

  1. const ExtractTextPlugin = require('extract-text-webpack-plugin');
  2. module.exports = {
  3. module: {
  4. rules: [
  5. {
  6. test: /\.scss$/,
  7. use: ExtractTextPlugin.extract({
  8. fallback: 'style-loader',
  9. use: ['css-loader', 'sass-loader']
  10. })
  11. }
  12. ]
  13. },
  14. plugins: [
  15. new ExtractTextPlugin('style.css')
  16. //如果想要传入选项,你可以这样做:
  17. //new ExtractTextPlugin({
  18. // filename: 'style.css'
  19. //})
  20. ]
  21. }

url() Resolving

If you are finding that urls are not resolving properly when you run webpack. You can expand your loader functionality with options. The url: false property allows your paths resolved without any changes.

  1. const ExtractTextPlugin = require('extract-text-webpack-plugin');
  2. module.exports = {
  3. module: {
  4. rules: [
  5. {
  6. test: /\.scss$/,
  7. use: ExtractTextPlugin.extract({
  8. fallback: 'style-loader',
  9. use: [
  10. {
  11. loader: 'css-loader',
  12. options: {
  13. // If you are having trouble with urls not resolving add this setting.
  14. // See https://github.com/webpack-contrib/css-loader#url
  15. url: false,
  16. minimize: true,
  17. sourceMap: true
  18. }
  19. },
  20. {
  21. loader: 'sass-loader',
  22. options: {
  23. sourceMap: true
  24. }
  25. }
  26. ]
  27. })
  28. }
  29. ]
  30. }
  31. }

修改文件名

filename 参数可以是 Function。它通过 getPath 来处理格式,如 css/[name].css,并返回真实的文件名,你可以用 css 替换 css/js,你会得到新的路径 css/a.css

  1. entry: {
  2. 'js/a': "./a"
  3. },
  4. plugins: [
  5. new ExtractTextPlugin({
  6. filename: (getPath) => {
  7. return getPath('css/[name].css').replace('css/js', 'css');
  8. },
  9. allChunks: true
  10. })
  11. ]

维护人员

ExtractTextWebpackPlugin - 图1


Juho Vepsäläinen

ExtractTextWebpackPlugin - 图2


Joshua Wiens

ExtractTextWebpackPlugin - 图3


Kees Kluskens

ExtractTextWebpackPlugin - 图4


Sean Larkin