Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

webpack中关于样式的处理 #9

Closed
zhengweikeng opened this issue Mar 22, 2016 · 27 comments

Comments

@zhengweikeng
Copy link
Owner

commented Mar 22, 2016

webpack对样式的处理

我们可以在js中引入样式文件

require('myStyle.css')

这时我们便需要引入相应的webpack loader来帮助我们解析这段代码。

一般来说需要引入css-loader和style-loader,其中css-loader用于解析,而style-loader则将解析后的样式嵌入js代码。

// webpack配置如下
{
  module: {
    loaders: [
      { test: /\.$/, loader: "style-loader!css-loader" }
    ]
  }
}

可以发现,webpack的loader的配置是从右往左的,从上面代码看的话,就是先使用css-loader之后使用style-loader。

同理,如果你使用less来写样式的话,则需要先用less-loader来编译样式文件为css文件,再继续使用css-loader与style-loader。

{
  module: {
    loaders: [
      { test: /\.$/, loader: "style-loader!css-loader!less-loader" }
    ]
  }
}

我们知道,webpack配置loader时是可以不写loader的后缀明-loader,因此css-loader可以写为css。

将样式抽取出来为独立的文件

将require引入的样式嵌入js文件中,有好处也有坏处。好处是减少了请求数,坏处也很明显,就是当你的样式文件很大时,造成编译的js文件也很大。

我们可以使用插件的方式,将样式抽取成独立的文件。使用的插件就是extract-text-webpack-plugin

基本用法如下

var ExtractTextPlugin = require("extract-text-webpack-plugin");
module.exports = {
  module: {
    loaders: [
      { test: /\.css$/, loader: ExtractTextPlugin.extract("style-loader", "css-loader") }
    ]
  },
  plugins: [
    new ExtractTextPlugin("styles.css")
  ]
}

根据插件在github上的解释,ExtractTextPlugin.extract可以有三个参数。
第一个参数是可选参数,传入一个loader,当css样式没有被抽取的时候可以使用该loader。
第二个参数则是用于编译解析的css文件loader,很明显这个是必须传入的,就像上述例子的css-loader。
第三个参数是一些额外的备选项,貌似目前只有传入publicPath,用于当前loader的路径。

那什么时候需要传入第一个参数呢,那就得明白什么时候样式不会被抽取出来。
了解过code splittiog的同学便会知道,我们有些代码在加载页面的时候不会被使用时,使用code splitting,可以实现将这部分不会使用的代码分离出去,独立成一个单独的文件,实现按需加载。

那么如果在这些分离出去的代码中如果有使用require引入样式文件,那么使用ExtractTextPlugin这部分样式代码是不会被抽取出来的。
这部分不会抽取出来的代码,可以使用loader做一些处理,这就是ExtractTextPlugin.extract第一个参数的作用。

根据上面的案例,ExtractTextPlugin需要配合plugin使用。

new ExtractTextPlugin([id: string], filename: string, [options])
  1. 该插件实例的唯一标志,一般是不会传的,其自己会生成。
  2. 文件名。可以是[name]、[id]、[contenthash]
    [name]:将会和entry中的chunk的名字一致
    [id]:将会和entry中的chunk的id一致
    [contenthash]:根据内容生成hash值
  3. options
    allchunk: 是否将所有额外的chunk都压缩成一个文件
    disable:禁止使用插件

这里的参数filename里如何理解呢?上述案例指定了一个固定的名字,因此便会生成一个styles.css文件。

那么像[name]、[id]这些如何理解。这个在你有多个entry的时候,便需要使用这种方式来命名。

var ExtractTextPlugin = require("extract-text-webpack-plugin");
module.exports = {
  entry: {
    "script": "./src/entry.js",
    "bundle": "./src/entry2.js",
  },
  ...
  module: {
    loaders: [
      { test: /\.css$/, loader: ExtractTextPlugin.extract("style-loader", "css-loader") }
    ]
  },
  plugins: [
    new ExtractTextPlugin("[name].css")
  ]
}

这时候便会生成两个css文件,一个是script.css,另一个便是bundle.css。那些[id]、[contenthash]也是一个道理。
只要明白,在你有多个entry是,一定要使用这种方式来命名css文件。

最后还有那个allchunks又是什么呢?很简单,还记得前面提到的code splitting么?将该参数配置为true,那么所有分离文件的样式也会全部压缩到一个文件上。

plugins: [
  new ExtractTextPlugin("[name].css", {allChunks: true})
]

postcss

以前我们写样式时,有些样式不同浏览器需要加不同的前缀,如-webkit-。现在有了构建工具,我们便不需要再去关注这些前缀了,构建工具会自动帮我们加上这些前缀。

对于webpack我们自然想到需要使用loader或者plugin来帮助我们做这些事情,查了下发现autoprefixer-loader已经废弃不再维护了,推荐使用posscss

postcss是用于在js中转换css样式的js插件,需要搭配其他插件一起使用,这点和babel6一样,本身只是个转换器,并不提供代码解析功能。

这里我们需要autoprefixer插件来为我们的样式添加前缀。首先下载该模块。

npm install autoprefixer --save-dev

接着便可以配置webpack了

var autoprefixer = require('autoprefixer')
module.exports = {
  ...
  module: {
    loaders: [
      ...
      {
        {
          test: /\.css$/,
          loader: ExtractTextPlugin.extract(["css-loader", "postcss-loader"])
        },
      }
    ]
  },
  postcss: [autoprefixer()],
  ...
}

查看一下抽取出来的样式文件便可以发现已经加上了前缀

a {
    display: flex;
}
/*compiles to:*/
a {
  display: -webkit-box;
  display: -webkit-flex;
  display: -ms-flexbox;
  display: flex
}

另外autoprefixer还可以根据目标浏览器版本生成不同的前缀个数,例如你的应用的使用用户如果大多数是使用比较新版本的浏览器,那么便可以做如下配置。

postcss: [autoprefixer({ browsers: ['last 2 versions'] })]

这是生成的样式便会有些不一样,还是上面的例子

a {
    display: flex;
}
/*compiles to:*/
a {
  display: -webkit-flex;
  display: -ms-flexbox;
  display: flex;
}

postcss后记

这里再说一个问题,有些童鞋可能会在css文件中使用@import引入其他样式文件,但是使用autoprefixer发现,import进来的样式没有处理,如下面所示:

/*myStyle.css:*/
body {
  background-color: gray;
}
.flex {
  display: flex;
}

/*myStyle2.css:*/
@import "./myStyle.css";
.div {
  color: red;
}

/*autoprefixer之后*/
body {
  background-color: gray;
}
.flex {
  display: -webkit-box;
  display: -webkit-flex;
  display: -ms-flexbox;
  display: flex;
}
body {
  background-color: gray;
}
.flex {
  display: flex;
}
.div {
  color: red;
}

要解决这个问题,postcss有个解释,它让我们使用postcss-import插件,再配合autoprefixer

postcss: function(webpack) {
  return [
    postcssImport({
      addDependencyTo: webpack
    }),
    autoprefixer
  ]
},

其实我们是不推荐使用@import的,心细的童鞋可以看到最后生成的样式文件有样式是重复的。
所以一般我们应该是在js中使用require来引入样式文件。可以参考的说法这里

样式压缩

压缩代码我们可以使用webpack的内置插件UglifyJsPlugin来做,它既可以压缩js代码也可以压缩css代码。

plugins: [
  ...
  new webpack.optimize.UglifyJsPlugin({
    compress: {
      warnings: false
    }
  }),
  ...
]

其实并不能说是在压缩css代码,本质来说还是压缩js代码,再将这块代码输出到css文件中。

使用CommonsChunkPlugin抽取公共代码

首先要明确一点CommonsChunkPlugin是在有多个entry时使用的,即在有多个入口文件时,这些入口文件可能会有一些共同的代码,我们便可以将这些共同的代码抽取出来成独立的文件。明白这一点非常重要。(搞了很久才明白的一点,唉~~~~)

如果在多个entry中require了相同的css文件,我们便可以使用CommonsChunkPlugin来将这些共同的样式文件抽取出来为独立的样式文件。

module.exports = {
  entry: {
    "A": "./src/entry.js",
    "B": "./src/entry2.js"
  },
  ...
  plugins: [
    new webpack.optimize.CommonsChunkPlugin({name: "commons", filename: "commons.js"}),
    ...
  ]
}

当然,这里不止会抽取共同的css,如果有共同的js代码,也会抽取成为commons.js。
这里有个有趣的现象,抽取出来的css文件的命名将会是参数中name的值,而js文件名则会是filename的值。

CommonsChunkPlugin好像只会将所有chunk中都共有的模块抽取出来,如果存在如下的依赖

// entry1.js
var style1 = require('./style/myStyle.css')
var style2 = require('./style/style.css')

// entry2.js
require("./style/myStyle.css")
require("./style/myStyle2.css")

// entry3.js
require("./style/myStyle2.css")

使用插件后会发现,根本没有生成commons.css文件。

如果我们只需要取前两个chunk的共同代码,我们可以这么做

module.exports = {
  entry: {
    "A": "./src/entry.js",
    "B": "./src/entry2.js",
    "C": "./src/entry3.js"
  },
  ...
  plugins: [
    new webpack.optimize.CommonsChunkPlugin({name: "commons", filename: "commons.js", chunks: ['A', 'B']}),
    ...
  ]
}

补充一下

根据webpack官网中关于stylesheet的说法,建议是不要将allChunks设为true,即只是将样式嵌入到分离文件中。
这个可能还是需要具体问题具体分析了。

@kainy

This comment has been minimized.

Copy link

commented Oct 27, 2016

了解过code splittiog的同学便会知道,我们有些代码在加载页面的时候不会被使用时,使用code splitting,可以实现将这部分不会使用的代码分离出去,独立成一个单独的文件,实现按需加载。
那么如果在这些分离出去的代码中如果有使用require引入样式文件,那么使用ExtractTextPlugin这部分样式代码是不会被抽取出来的。
这部分不会抽取出来的代码,可以使用loader做一些处理,这就是ExtractTextPlugin.extract第一个参数的作用。

具体如何使用呢,https://github.com/webpack/extract-text-webpack-plugin插件主页里并没有找到,所以在这里请教下。

@zhengweikeng

This comment has been minimized.

Copy link
Owner Author

commented Oct 29, 2016

我举个简单的例子好了

// entry.js

require('./main.css')
let hello = null

// 代码分离
require.ensure([], function(require) {
  hello = require('./hello').default
})

$("#hello").click(() => {
  hello()
})

在hello.js中我们引用一个css文件

// hello.js

require('./normal.css')
export default () => {
  console.log('hello~~')
}

假设我们两个css文件内容如下:

// main.css
body {
  color: red;
}

// normal.css
h1 {
  color: blue
}

此时我们在webpack配置loader时这么写

...
module: {
    loaders: [
      { 
        test: /\.js$/, 
        loader: 'babel', 
        query: {
          presets: ['es2015']
        }
      }, { 
        test: /\.css$/, 
        loader: ExtractTextPlugin.extract("style-loader", ["css-loader"]) 
      }
    ]
  },
  plugins: [
    // allChunks 默认是false
    new ExtractTextPlugin("[name].styles.[id].[contenthash].css", {allChunks: false}),
  ]
...

注意我们在 ExtractTextPlugin.extract第一个参数传入了style-loader,这个参数便是给像被代码分离后的chunk用的,表明这些无法被抽取的chunk的处理方式,既使用style-loader,将其嵌入到页面的style标签中。

这时到页面上看,就会发现h1标签的文字是蓝色的(normal.css定义的),而不是红色的。

这时我们尝试把ExtractTextPlugin.extract的第一个参数删除掉,会发现,这时h1标签的文字变为红色(main.css定义的)了,normal.css的样式也没有被嵌入到页面中。

这便是第一个参数的作用

@zhengweikeng

This comment has been minimized.

Copy link
Owner Author

commented Oct 29, 2016

如果我们也想要将normal.css的样式代码抽取到文件中,我们可以将allChunks设置为true,即

plugins: [
    // allChunks 默认是false
    new ExtractTextPlugin("[name].styles.[id].[contenthash].css", {allChunks: true})
  ]
@KeithChou

This comment has been minimized.

Copy link

commented Oct 31, 2016

请问楼主,如何给.vue组件中的样式在编译之后添加属性前缀?

@zhengweikeng

This comment has been minimized.

Copy link
Owner Author

commented Nov 1, 2016

@KeithChou
vue-loader本身已经支持autoprefixer了

loaders: [
  {
      test: /\.vue$/,
      loader: "vue"
  },
  ...
],
vue: { // 配置vue
    loaders: {
      css: ExtractTextPlugin.extract("css"),
      less: ExtractTextPlugin.extract("css!less")
    },
    autoprefixer: {
      browsers: ['last 2 versions']
    }
},
@KeithChou

This comment has been minimized.

Copy link

commented Nov 1, 2016

在vue选项对象中使用ExtractTextPlugin.extract,这个插件的作用是把vue中style标签中的样式单独写到一个文件去. 我把你给的代码运行了一次..还是没有前缀...

.haha p[data-v-a64cfc10] {
    background-color: red;
    border-radius: 10px;
    box-shadow: 3px 3px 3px #ccc;
    color: red;
    display: flex;
    font-weight: bold;
    height: 100px;
    transition: all 0.3s ease 0s;
}

还是不行啊....

@KeithChou

This comment has been minimized.

Copy link

commented Nov 1, 2016

而且,我在autoprefixer官网上看到这样一段话...

No prefixes in production
Many other tools contain Autoprefixer. For example, webpack uses Autoprefixer to minify CSS by cleaning unnecessary prefixes.
If you set browsers list to Autoprefixer by browsers option, only first Autoprefixer will know your browsers. Autoprefixer inside webpack will use default browsers list. As result, webpack will remove prefixes, that first Autoprefixer added.
You need to put your browsers to browserslist config in project root — as result all tools (Autoprefixer, cssnano, doiuse, cssnext) will use same browsers list.

@kainy

This comment has been minimized.

Copy link

commented Nov 1, 2016

@zhengweikeng 感谢博主耐心解答,说的很透彻,改天试试。

@Tinyuen

This comment has been minimized.

Copy link

commented Nov 30, 2016

写得很棒!浅显易懂 mark

@ghost

This comment has been minimized.

Copy link

commented Dec 8, 2016

写得很棒!浅显易懂 mark

@xiaxiangfeng

This comment has been minimized.

Copy link

commented Dec 15, 2016

你好,谢谢。
我的问题是这样的:
我使用的webpack,在.vue文件里我这样引入了css文件

<script> import Yang from './main.css' </script>

配上是这样的
vue: {
loaders: utils.cssLoaders({ sourceMap: useCssSourceMap }),
postcss: [
require('autoprefixer')({
browsers: ['last 2 versions']
})
]
}
但是 autoprefixer并没有对main.css做处理。
请问,我需要怎么改配件文件。谢谢。
PS:配置文件都是vue-cli,构建的。

@DeepenLau

This comment has been minimized.

Copy link

commented Jan 17, 2017

@xiaxiangfeng .vue 里面的样式应该这样引入 <style src="./main.css"></style>

@super-LEON

This comment has been minimized.

Copy link

commented Jan 18, 2017

“首先要明确一点CommonsChunkPlugin是在有多个entry时使用的,即在有多个入口文件时,这些入口文件可能会有一些共同的代码,我们便可以将这些共同的代码抽取出来成独立的文件。明白这一点非常重要”,如果只有一个entry,比如是react的入口文件,这个文件里面配置了很多路由,里面各路由js文件里的require的公共代码会被提取吗?

@AlanZhang001

This comment has been minimized.

Copy link

commented Jan 20, 2017

请问楼主,ExtractTextPlugin抽取出来的公共css文件如果加载到html中呢?不是应该自动加入吗?

@xiaobinwu

This comment has been minimized.

Copy link

commented Mar 17, 2017

@xiaxiangfeng 可以修改utils.cssLoaders方法,默认vue配置只针对.vue文件中style标签样式,对于require没有办法autoprefixer,所以可以这样修改utils.cssLoaders:
less: generateLoaders(['css', 'autoprefixer?{browsers:[">5%"]}','less']),
补充autoprefixer的loader,注意顺序问题loader加载,从右往左
autoprefixer没有sourceMap配置,需要在sourceLoader中将其剔除,避免添加sourceMap

@yjzzcao

This comment has been minimized.

Copy link

commented May 26, 2017

image

有什么办法让抽离出来的css改变添加位置吗?

因为css必须在respond之前引入,不然媒体查询ie8下面无效

@Iamlars

This comment has been minimized.

Copy link

commented Jun 9, 2017

经试验,webpack.optimize.UglifyJsPlugin并不能压缩css代码,{loader: 'css-loader',options: {minimize: true}},反而可以。。

@backlost

This comment has been minimized.

Copy link

commented Jun 20, 2017

楼主,当我有多个入口,但我只想要指定其中的一个入口时候应该怎么做呢

@salcabar

This comment has been minimized.

Copy link

commented Jun 23, 2017

@Iamlars 你测试的应该是webpack2的版本,webpack1应该是默认带压缩css的

@ShiChenCong

This comment has been minimized.

Copy link

commented Jun 30, 2017

赞! 2的版本 需这么写use: ExtractTextPlugin.extract({fallback: 'style-loader', use: ['css-loader', 'less-loader']})

@jesshyl

This comment has been minimized.

Copy link

commented Aug 18, 2017

楼主写的很好,刚学webpack,extract函数中的use和fallback,为什么css-loader(提取css)是use,style-loader(把style插到头部)是fallback,我自己试了一下您在评论区的例子,写成extract(["css-loader","postcss-loader"])会把normal.css并入main.css,改成style-loader或者去掉css-loader则会编译报错

@waitinghope

This comment has been minimized.

Copy link

commented Oct 1, 2017

请教大家一个问题,我发现webpack使用style-loader的时候,这个插件会把import的css规则动态的插入到当前页面的head头,这个对性能是不好的吧?应该怎么解决?或者怎么让它把多个style节点合并呢?谢谢。

@niaogege

This comment has been minimized.

Copy link

commented Oct 15, 2017

请问楼主,如何把一个css样式文件分割,就像js那样,有公共的js,一般是vendor.hash.js, 当然还有缓存的manifest.hash.js,我现在项目中遇到,打包编译之后的css达到400kb,有什么方法可以分割几个?或者像js那样按需加载?我用的是最新版的vue-cli里的webpack模板,webpack3.6.0,vue-loader13.0.4,谢谢

@wjf444128852

This comment has been minimized.

Copy link

commented Nov 30, 2017

     module.exports = {
         plugins: {
           'postcss-import': {},
            'postcss-cssnext': {
                 browsers: ['last 2 versions', '> 5%']
            },
          'autoprefixer':{
            browsers: ['last 2 versions']
           }
      }
  }
   // 1、这样配置CSS中可以自动追加浏览器前缀,
   {
                test: /\.css$/,
                use: ExtractTextPlugin.extract({
                    fallback: "style-loader",
                    // use: 'css-loader',
                    use:[
                        { loader: "css-loader", options: { importLoaders: 1 }},
                        "postcss-loader"
                    ]
                })
            },
      // 2、如果想在stylus中也可以该如何配置?目前如下这样配置不起作用~
      {
                test:/\.styl$/,
                use:ExtractTextPlugin.extract({
                    fallback:"style-loader",
                    use:[
                        "css-loader",
                        "postcss-loader",/////------------------
                        "stylus-loader"
                    ]
                })
            }
@wjf444128852

This comment has been minimized.

Copy link

commented Nov 30, 2017

不好意思忘记重启服务!!上面的配置位置是正确的!!包括scss、和less这样都已经可以自动追加前缀了

    
      { 
                test: /\.scss$/,
                use: ExtractTextPlugin.extract({
                    fallback: 'style-loader',
                    use: [
                        "css-loader",
                        "postcss-loader",
                        "sass-loader"
                    ]
                })
            }

        {
                test:/\.less$/,
                use:ExtractTextPlugin.extract({
                    fallback:"style-loader",
                    use:[
                        "css-loader",
                        "postcss-loader",
                        "less-loader"
                    ]
                })
            }

@bigbigbo

This comment has been minimized.

Copy link

commented Aug 9, 2018

关于CommonsChunkPluginExtractTextPlugin这块受教了,今天一直纳闷为啥没有抽取公共样式的问题在你这找到答案了。

@Xavier0818

This comment has been minimized.

Copy link

commented Apr 16, 2019

mark,正在学习

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
You can’t perform that action at this time.