学过网页开发就会知道，CSS 不能算编程语言，只是网页样式的一种描述方法。

为了让 CSS 也能适用软件工程方法，程序员想了各种办法，让它变得像一门编程语言。从最早的Less、SASS，到后来的 PostCSS，再到最近的 CSS in JS，都是为了解决这个问题。

本文介绍的 CSS Modules 有所不同。它不是将 CSS 改造成编程语言，而是功能很单纯，只加入了局部作用域和模块依赖，这恰恰是网页组件最急需的功能。

因此，CSS Modules 很容易学，因为它的规则少，同时又非常有用，可以保证某个组件的样式，不会影响到其他组件。

零、示例库

我为这个教程写了一个示例库，包含六个Demo。通过它们，你可以轻松学会CSS Modules。

首先，克隆示例库。


$ git clone https://github.com/ruanyf/css-modules-demos.git

然后，安装依赖。


$ cd css-modules-demos
$ npm install

接着，就可以运行第一个示例了。


$ npm run demo01

http://localhost:8080

一、局部作用域

CSS的规则都是全局的，任何一个组件的样式规则，都对整个页面有效。

class
App.js

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

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

App.cssstylestyle.titleclass

.title {
  color: red;
}

style.title

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

App.css

._3zyde4l1yATCOkgn-DBWEL {
  color: red;
}

App
css-loaderWebpack-Demos
webpack.config.js

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"
      },
    ]
  }
};

style-loader!css-loader?modulescss-loadermodules

现在，运行这个Demo。


$ npm run demo01

h1

二、全局作用域

:global(.className)class
App.cssclass

.title {
  color: red;
}

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

App.jsclassclass

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

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

运行这个示例。


$ npm run demo02

h1
:local(.className).classNameApp.css

:local(.title) {
  color: red;
}

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

三、定制哈希类名

css-loader[hash:base64].title._3zyde4l1yATCOkgn-DBWEL
webpack.config.js

module: {
  loaders: [
    // ...
    {
      test: /\.css$/,
      loader: "style-loader!css-loader?modules&localIdentName=[path][name]---[local]---[hash:base64:5]"
    },
  ]
}

运行这个示例。


$ npm run demo03

.titledemo03-components-App---title---GpMto

四、 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>
  );
};

运行这个示例。


$ npm run demo04

http://localhost:8080h1
App.css

._2DHwuiHWMnKTOYG45T0x34 {
  color: red;
}

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

h1class

五、输入其他模块

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


.className {
  background-color: blue;
}

App.cssanother.css

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

运行这个示例。


$ npm run demo05

http://localhost:8080h1

六、输入变量

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


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

postcss-loaderwebpack.config.js

var 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;
}

运行这个示例。


$ npm run demo06

http://localhost:8080h1

（完）