CSSModules

CSS Modules

这篇文章来一起了解 css 模块化的用法和原理 ,dome 地址:css modules 😮


局部作用域

一般我们引入页面的 CSS 的作用域都是全局的,都是对这个页面起作用,产生局部的作用域,就是使用一个独一无二的 class 的名称,不会和其它选择器重名的, CSS Modules 就是这个原理。下面我们看一段代码

1
2
3
4
5
6
7
import $ from 'jquery';
import styles from './main.css';
import test from './test.html';

$('body').append($('<div><h1>我会变绿</h1></div>'));
$('div h1').addClass(styles.testGreen);
$('body').append(test).find('h2').addClass(styles.testBlue);

上面的代码我把 main.css 输入到 style 对象,然后下面用了 styles.testGreen 对象的属性形式调用,就会应用 main.css 里的样式

1
2
3
.testGreen {
color: green;
}

构建工具( webpack )编译成一个哈希字符串

1
2
3
<div>
<h1 class="_305zeUSoiGREv3GqPa9H8F">我会变绿</h1>
</div>

main.css 也会同时编译

1
2
3
._305zeUSoiGREv3GqPa9H8F {
color: #aaf200;
}

这样一来,这个类名就是独一无二的了,只对应用的组件有效。 CSS Modules 支持不同的构建工具,这里我使用的是 webpack ,下文都是以 webpack 为例。

下面我们来看下 webpack.config.js

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
module.exports = {
context: __dirname + '/src',
devtool: 'eval-source-map', //配置生成Source Maps,选择合适的选项
entry: {
app: ['./app.js', './test.js'],
},
output: {
path: __dirname + '/dist',
filename: 'bundle.js',
publicPath: '/assets',
},
module: {
loaders: [
{test: /\.json$/,loader: 'json-loader'},
{test: /\.js$/,exclude: /node_modules/,loader: 'babel-loader'},
{test: /\.css$/,loader: ExtractTextPlugin.extract({
fallbackLoader: "style-loader",
loader: {
loader: "css-loader",
query: {
modules: true
}
}
})
},
{test: /\.html$/,loader: 'html-loader'},
]
},
plugins: [
new ExtractTextPlugin('style.css')
]
};

上面的代码可以看到,query:{modules:true} 代表开启 CSS Modules 模块,这里还配置了把所以得 css 合并一个文件,具体的可以了解 webpackextract-text-webpack-plugin插件。

全局作用域

CSS Modules 允许用 :global(.className) 的语法声明一个全局的作用域。加了 :global 的不会被编译成哈希值。

1
2
3
4
5
6
7
:global(.title) {
color: black;
}

.title {
color: red;
}

test.js 使用普通的写法,就会引用全局的 .title 的样式

1
2
3
4
5
6
import $ from 'jquery';
import styles from './main.css';
import test from './test.html';

$('body').append($('<div><h1>我是title</h1></div>'));
$('div h1').addClass('title');

结果 h1 的title显示黑色。

Class的组合

CSS Modules 里,一个选择器可以继承另一个选择器。

mian.css 里,我让 .testBlue 继承 .testBg

1
2
3
4
5
6
7
8
.testBg {
background-color: red;
}

.testBlue {
color: blue;
composes: testBg;
}

不用修改 test.js ,应用了 .testBlue 就会有一个红色的背景。

编译结果:

1
2
3
4
5
6
7
.eh33VC37uFHXkCZ8LfKYd {
background-color: #ff0000;
}

.xrmZso54fTBX29J9G65Ai {
color: #0c77f8;
}

相应的 html 代码:

1
2
3
<h3 class="xrmZso54fTBX29J9G65Ai eh33VC37uFHXkCZ8LfKYd _2gsuNWm9029FHPYJP62C-t">
我会变蓝
</h3>

输入变量

CSS Modules 支持使用变量,不过要安装 PsotCSSpostcss-modules-values

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

postcss-loader 加入 webpack.config.js .

1
2
3
4
{
test: /\.css$/,
loader: 'style-loader!css-loader?modules!postcss-loader'
},

然后我在 colors.css 里定义了一些变量。

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

main.css 里可以这样引用变量

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
@value colors: "./color.css";
@value blue, red, green from colors;

.title {
color: red;
}

.testBg {
background-color: red;
}

.testGreen {
color: green;
}

.testBlue {
color: blue;
composes: testBg;
composes: div;
}

这样就可以把 colors.css 的变量拿过来用了,是不是很神奇。

本文结束感谢您的阅读

本文标题:CSSModules

文章作者:李少颖(persilee)

发布时间:2018年04月07日 - 09:04

最后更新:2018年05月22日 - 02:05

原始链接:https://www.h.lishaoy.net/CSSModules.html

许可协议: 署名-非商业性使用-禁止演绎 4.0 国际 转载请保留原文链接及作者。

坚持原创技术分享,您的支持将鼓励我继续创作!