位置：首页-资讯-后端开发

CSS Module如何使用

2023-07-05 00:39

短信预约 -IT技能 免费直播动态提醒

本文小编为大家详细介绍“CSS Module如何使用”，内容详细，步骤清晰，细节处理妥当，希望这篇“CSS Module如何使用”文章能帮助大家解决疑惑，下面跟着小编的思路慢慢深入，一起来学习新知识吧。

CSS Modules 用法

示例库

首先，克隆示例库。

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

然后，安装。

$ cd css-modules-demos
$ npm install

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

$ npm run demo01

打开浏览器，访问http://trustauth.cn: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://trustauth.cn: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://trustauth.cn: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://trustauth.cn: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://trustauth.cn: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
]
};