参考文章
CSS Modules 的用法
CSS Modules 的功能很单纯,只加入了局部作用域和模块依赖,可以保证某个组件的样式,不会影响到其他组件。
局部作用域
CSS的规则都是全局的,任何一个组件的样式规则,都对整个页面有效。
产生局部作用域的唯一方法,就是使用一个唯一的 class
的名字,不会与其他选择器重名。这就是 CSS Modules 的做法。
示例代码:
// index.tsx
import React from 'react';
import styles from './index.less'const Create: React.FC = () => {return <><div className={styles.titleName)></div></>
}
上面代码中,将样式文件 index.less 输入到 style
对象,然后引用 style.titleName
代表一个 class
。
.titleName {height: 18px;line-height: 18px;border-left: 4px solid #4461eb;font-size: 14px;padding-left: 8px;margin-left: 16px;
}
构建工具会将类名 style.titleName
编译成一个哈希字符串。
<div class="titleName___ua3pe">标题
</div>
index.less 也会同时被编译。
.titleName___ua3pe {height: 18px;line-height: 18px;border-left: 4px solid #4461eb;font-size: 14px;padding-left: 8px;margin-left: 16px;
}
这样一来,这个类名就变成唯一的了,只对 Create
组件有效。
CSS Modules 提供各种插件,支持不同的构建工具。上面使用的是 Webpack 的css-loader
插件,因为它对 CSS Modules 的支持最好,而且很容易使用。
下面是这个示例的 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 功能。
全局作用域
CSS Modules 允许使用:global(.className)
的语法,声明一个全局规则。凡是这样声明的class
,都不会被编译成哈希字符串。
使用 css modules 的方式引入的 less 文件,如果需要复写 antd 组件样式,需要加上全局标识:
:global {.ant-upload-select {margin-left: -12px;}.ant-upload-list {position: absolute;width: 80%;left: 24px;top: 0px}
}