CSS Modules用法教程

CSS模块

CSS模块就是所有的类名都只有局部作用域的CSS文件。
在使用CSS模块时，类名是动态生成的，唯一的，并准确对应到源文件中的各个类的样式。

这也是实现样式作用域的原理。它们被限定在特定的模板里。例如我们在buttons.js里引入buttons.css文件，并使用.btn的样式，在其他组件里是不会被.btn影响的，除非它也引入了buttons.css。

局部作用域

CSS的规则都是全局的，任何一个组件的样式规则，都对整个页面有效。
产生局部作用域的唯一方法是：使用一个独一无二的class的名字，不会与其他选择器重名。这就是 CSS Modules 的做法。
如下React组件App.js：

import React from 'react';
import style from './App.css';

export default () => {
  return (
    <h1 className={style.title}>
      Hello World
    </h1>
  );
};

上面代码中：我们将样式文件App.css输入到style对象，然后引用style.title代表一个class。

.title {
  color: red;
}

构建工具会将类名style.title编译成一个哈希字符串。

<h1 class="_3zyde4l1yATCOkgn-DBWEL">
  Hello World
</h1>

App.css也会同时被编译:

._3zyde4l1yATCOkgn-DBWEL {
  color: red;
}

这样一来，这个类名就变成独一无二了，只对App组件有效。

开启CSS Modules 功能

{
  test: /\.css$/,
  use: [
    {
      loader: 'css-loader',
      options: {
        modules: true
      }
    }
  ]
}

上面代码中：关键的一行是modules: true，它表示打开 CSS Modules 功能。

全局作用域

CSS Modules 允许使用:global(.className)的语法，声明一个全局规则。凡是这样声明的class，都不会被编译成哈希字符串。
App.css加入一个全局class：

.title {
  color: red;
}
/*全局样式*/
:global(.title) {
  color: green;
}

App.js使用普通的class的写法，就会引用全局class。

import React from 'react';
import styles from './App.css';

export default () => {
  return (
    <h1 className="title">
      Hello World
    </h1>
  );
};

运行这个示例。
打开 http://localhost:8080，应该会看到h1标题显示为绿色而不是红色。

CSS Modules 还提供一种显式的局部作用域语法:local(.className)，等同于.className，所以上面的App.css也可以写成下面这样。

/*显式的局部作用域语法*/
:local(.title) {
  color: red;
}

:global(.title) {
  color: green;
}

定制哈希类名

css-loader默认的哈希算法是[hash:base64]，这会将.title编译成._3zyde4l1yATCOkgn-DBWEL这样的字符串。
webpack.config.js里面可以定制哈希字符串的格式。

{
  test: /\.css$/,
  use: [
    {
      loader: 'css-loader',
      options: {
        modules: true,//开启CSS Modules
        localIdentName: '[path][name]__[local]--[hash:base64:5]'
      }
    }
  ]
}

Class 的组合

在 CSS Modules 中，一个选择器可以继承另一个选择器的规则，这称为”组合”（”composition”）。
在App.css中，让.title继承.className 。

.className {
  background-color: blue;
}
.title {
  composes: className;/*继承规则*/
  color: red;
}

App.js不用修改。

import React from 'react';
import style from './App.css';

export default () => {
  return (
    <h1 className={style.title}>
      Hello World
    </h1>
  );
};

运行这个示例。
打开http://localhost:8080，会看到红色的h1在蓝色的背景上。
App.css编译成下面的代码：

._2DHwuiHWMnKTOYG45T0x34 {
  color: red;
}

._10B-buq6_BEOTOl9urIjf8 {
  background-color: blue;
}

相应地， h1的class也会编译成：

<h1 class="_2DHwuiHWMnKTOYG45T0x34 _10B-buq6_BEOTOl9urIjf8">。

输入其他模块

选择器也可以继承其他CSS文件里面的规则。
style.css

.className {
  background-color: blue;
}

App.css可以继承style.css里面的规则。

.title {
  composes: className from './style.css';
  color: red;
}

输入变量

CSS Modules 支持使用变量，不过需要安装 PostCSS 和 postcss-modules-values。

$ npm install --save postcss-loader postcss-modules-values

把postcss-loader加入webpack.config.js。

const values = require('postcss-modules-values');

module.exports = {
  entry: __dirname + '/index.js',
  output: {
    publicPath: '/',
    filename: './bundle.js'
  },
  module: {
    loaders: [
      {
        test: /\.jsx?$/,
        exclude: /node_modules/,
        loader: 'babel',
        query: {
          presets: ['es2015', 'stage-0', 'react']
        }
      },
      {
        test: /\.css$/,
        loader: "style-loader!css-loader?modules!postcss-loader"
      },
    ]
  },
  postcss: [
    values
  ]
};

接着，在colors.css里面定义变量：

@value blue: #0c77f8;
@value red: #ff0000;
@value green: #aaf200;

App.css可以引用这些变量：

@value colors: "./colors.css";
@value blue, red, green from colors;

.title {
  color: red;
  background-color: blue;
}

运行这个示例。
打开http://localhost:8080，会看到蓝色的背景上有一个红色的h1。
参考博文：
CSS Modules 用法教程
 CSS Modules 入门及 React 中实践