售前咨询
技术支持
渠道合作

带有风格的编码——CSS Module

CSS 是前端领域中进化最慢的一块。由于 ES2015/2016 的快速普及和 Babel/Webpack 等工具的迅猛发展,CSS 被远远甩在了后面,逐渐成为大型项目工程化的痛点。也变成了前端走向彻底模块化前必须解决的难题。

CSS 模块化的解决方案主要有两类。一类是彻底抛弃 CSS,使用 JS 或 JSON 来写样式。Radium,jsxstyle,react-style 属于这一类。优点是能给 CSS 提供 JS 同样强大的模块化能力;缺点是不能利用成熟的 CSS 预处理器(或后处理器) Sass/Less/PostCSS,`:hover和 `:active` 伪类处理起来复杂。另一类是依旧使用 CSS,但使用 JS 来管理样式依赖,代表是 CSS Modules。CSS Modules 能最大化地结合现有 CSS 生态和 JS 模块化能力,API 简洁到几乎零学习成本。发布时依旧编译出单独的 JS 和 CSS。它并不依赖于 React,只要使用 Webpack,可以在 Vue/Angular/jQuery 中使用。

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的名字,不会与其他选择器重名。这就是 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 提供各种插件,支持不同的构建工具。本文使用的是 Webpack 的css-loader插件,因为它对 CSS Modules 的支持最好,而且很容易使用。顺便说一下,如果你想学 Webpack,可以阅读我的教程Webpack-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?modules,它在css-loader后面加了一个查询参数modules,表示打开 CSS Modules 功能。

现在,运行这个Demo。

$ npm run demo01

打开 http://localhost:8080 ,可以看到结果,h1标题显示为红色。

二、全局作用域

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>

);

};

运行这个示例。

$ npm run demo02

打开 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里面可以定制哈希字符串的格式。

module: {

loaders: [

// …

{

test: /\.css$/,

loader: “style-loader!css-loader?modules&localIdentName=[path][name]—[local]—[hash:base64:5]”

},

]

}

运行这个示例。

$ npm run demo03

title被编译成了demo03-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:8080,会看到红色的h1在蓝色的背景上。

App.css编译成下面的代码。

._2DHwuiHWMnKTOYG45T0x34 {

color: red;

}

._10B-buq6_BEOTOl9urIjf8 {

background-color: blue;

}

相应地, h1的class也会编译成<h1 class=”_2DHwuiHWMnKTOYG45T0x34 _10B-buq6_BEOTOl9urIjf8″>。

五、输入其他模块

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

another.css

.className {

background-color: blue;

}

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

.title {

composes: className from ‘./another.css’;

color: red;

}

运行这个示例。

$ npm run demo05

打开http://localhost:8080,会看到蓝色的背景上有一个红色的h1。

六、输入变量

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

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

把postcss-loader加入webpack.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:8080,会看到蓝色的背景上有一个红色的h1。


代码签名证书是保护开发者的劳动成果,给自己开发的软件签名的证书,保证代码在签名之后不被恶意篡改。用户可通过对代码的数字签名来标识软件来源,辨别软件开发者的真实身份。GDCA的代码签名证书支持多种代码签名,已通过WEBTRUST国际认证。

上一篇:

下一篇:

相关文章