CSS Modules 解决 react 项目 css 样式互相影响的问题
CSS Modules 解决 react 项目 css 样式互相影响的问题
1. CSS Modules引入目的
写过CSS的人，应该都对一大长串选择器选中一个元素不陌生吧，这种方式，其实定义的就是全局样式，我们时常会因为选择器权重问题，没有把我们想要的样式加上去。
另外，每次都需要把所有的样式表都导入到程序中，如果我们可以像使用js模块一样，想用哪块就用哪块，是不是就很理想了。
CSS Modules就解决了这个问题，它自动为每一个类生成一个哈希值，可以惟一标志这个类，因此避免了我们说的第一个问题，它让我们可以像使用js模块那样，想用哪部分样式，就引入哪部分样式。下面我们来具体介绍它的使用方法。
2.CSS Modules使用方法
1) 如何在开启CSS Modules
create-react-app 脚手架 引入 css-modules
modules:true,
localIdentName:'\[name\]\_\_\[local\]\_\_\[hash:base64:5\]'webpack.config.dev.js
{
test: /.less$/,
exclude: /node\_modules|antd.css/,
use: \[
require.resolve('style-loader'),
{
loader: require.resolve('css-loader'),
options: {
importLoaders: 1,
modules:true,
localIdentName:'\[name\]\_\_\[local\]\_\_\[hash:base64:5\]'
},
},
{
loader: require.resolve('postcss-loader'),
options: {
// Necessary for external CSS imports to work
// https://github.com/facebookincubator/create-react-app/issues/2677
ident: 'postcss',
plugins: () => \[
require('postcss-flexbugs-fixes'),
autoprefixer({
browsers: \[
'>1%',
'last 4 versions',
'Firefox ESR',
'not ie < 9', // React doesn't support IE8 anyway
\],
flexbox: 'no-2009',
}),
\],
},
},
{
loader: require.resolve('less-loader') // compiles Less to CSS
}
\],
},
{
test: /.css$/,
use: \[
require.resolve('style-loader'),
{
loader: require.resolve('css-loader'),
options: {
importLoaders: 1,
},
},
{
loader: require.resolve('postcss-loader'),
options: {
// Necessary for external CSS imports to work
// https://github.com/facebookincubator/create-react-app/issues/2677
ident: 'postcss',
plugins: () => \[
require('postcss-flexbugs-fixes'),
autoprefixer({
browsers: \[
'>1%',
'last 4 versions',
'Firefox ESR',
'not ie < 9', // React doesn't support IE8 anyway
\],
flexbox: 'no-2009',
}),
\],
},
},
\],
},
webpack.config.prod.js
{
test: /.less$/,
exclude: /node\_modules|antd.css/,
loader: ExtractTextPlugin.extract(
Object.assign(
{
fallback: {
loader: require.resolve('style-loader'),
options: {
hmr: false,
},
},
use: \[
{
loader: require.resolve('css-loader'),
options: {
importLoaders: 1,
modules:true,
localIdentName:'\[name\]\_\_\[local\]\_\_\[hash:base64:5\]',
minimize: true,
sourceMap: shouldUseSourceMap,
},
},
{
loader: require.resolve('postcss-loader'),
options: {
// Necessary for external CSS imports to work
// https://github.com/facebookincubator/create-react-app/issues/2677
ident: 'postcss',
plugins: () => \[
require('postcss-flexbugs-fixes'),
autoprefixer({
browsers: \[
'>1%',
'last 4 versions',
'Firefox ESR',
'not ie < 9', // React doesn't support IE8 anyway
\],
flexbox: 'no-2009',
}),
\],
},
},
{
loader: require.resolve('less-loader') // compiles Less to CSS
}
\],
},
extractTextPluginOptions
)
),
// Note: this won't work without \`new ExtractTextPlugin()\` in \`plugins\`.
},
{
test: /.css$/,
loader: ExtractTextPlugin.extract(
Object.assign(
{
fallback: {
loader: require.resolve('style-loader'),
options: {
hmr: false,
},
},
use: \[
{
loader: require.resolve('css-loader'),
options: {
importLoaders: 1,
minimize: true,
sourceMap: shouldUseSourceMap,
},
},
{
loader: require.resolve('postcss-loader'),
options: {
// Necessary for external CSS imports to work
// https://github.com/facebookincubator/create-react-app/issues/2677
ident: 'postcss',
plugins: () => \[
require('postcss-flexbugs-fixes'),
autoprefixer({
browsers: \[
'>1%',
'last 4 versions',
'Firefox ESR',
'not ie < 9', // React doesn't support IE8 anyway
\],
flexbox: 'no-2009',
}),
\],
},
},
\],
},
extractTextPluginOptions
)
),
// Note: this won't work without \`new ExtractTextPlugin()\` in \`plugins\`.
},
2）CSS Modules用法
1.基本使用方法
在你的项目中，添加一个CSS文件，然后你就可以像引入js模块一样，在你的js文件中引入这个文件存放到一个对象中。这个对象中是一个包含连个属性的对象，其值就是自动生成的类名。这个类名也会替换页面中的类名。
style.scss
/\* style.scss \*/
.bgRed {
background-color: #f00;
}
app/app.js
/\* app/app.js \*/
import React, {Component} from 'react';
import ReactDOM from 'react-dom';
/\* 引入我们定义的.scss文件 \*/
import styles from '../style/style.scss';
/\* 使用无状态函数定义我们的组件\*/
function Title() {
console.log(styles);
/\* 打印引入的styles，是一个包含连个属性的对象，其值就是自动生成的类名
Object {white: "\_24PAw-tvdzL8pt4nyAvnJX", bgRed: "\_2R9YNZv7rx\_o02FHxKTBzC"}
\*/
return (
/\* 在组件中引用 \*/
<h1 className={styles.bgRed}>Hello React!</h1>
);
}
/\* 渲染到页面中 \*/
ReactDOM.render(<Title />, document.body );最终页面结构，如下图所示：
2. 自定义命名规则
上面生称的类名，完全是自动生成，如果自己自己规定命名规则呢，也是很简单的，只需要在上面配置modules后面添加&localIdentName＝配置规则，如：
'css-loader?modules&localIdentName=[name]__[local]-[hash:base64:5]' //style__bgRed-2R9YN,local对应所在文件夹名，local对应文件名，最后是哈希值
3. 全局类名和本地类名
我们可以使用:global(className)来标识这个类是全局类名，因此CSS Modules不对其类名进行转化，:local(className)则相反，如果不用这两个包裹的话，默认是local.
style.scss
/\* style.scss \*/
.bgRed {
background-color: #f00;
}
// 添加全局bgRed
:global(.bgRed) {
}app/app.js
/\* app/app.js \*/
import React, {Component} from 'react';
import ReactDOM from 'react-dom';
/\* 引入我们定义的.scss文件 \*/
import styles from '../style/style.scss';
/\* 使用无状态函数定义我们的组件\*/
function Title() {
console.log(styles);
return (
/\* 在组件中全局的bgRed,此时我们可以访问到我们全局定义的bgRed，它并没有被转化 \*/
<h1 className="bgRed"}>Hello React!</h1>
);
}
/\* 渲染到页面中 \*/
ReactDOM.render(<Title />, document.body );4. 使用composes组合样式
我们知道，node.js中，我们可以用require引入模块，然后使用它们。CSS Modules也提供了composes来该文件中的样式规则，甚至引用其它文件中的样式规则。
style/style.scss
/\* style/style.scss \*/
.fontWhite {
color: #fff;
}
.bgRed {
composes: fontWhite;
background-color: #f00;
}app/app.js
/\* app/app.js \*/
import React, {Component} from 'react';
import ReactDOM from 'react-dom';
/\* 引入我们定义的.scss文件 \*/
import styles from '../style/style.scss';
/\* 使用无状态函数定义我们的组件\*/
function Title() {
console.log(styles);
/\* 打印引入的styles，是一个包含连个属性的对象，其值就是自动生成的类名
Object {fontWhite: "style\_\_fontWhite-3jipu", bgRed: "style\_\_bgRed-2R9YN style\_\_fontWhite-3jipu"}rx\_o02FHxKTBzC"}
\*/
return (
/\* 在组件中引用 \*/
<h1 className={styles.bgRed}>Hello React!</h1>
);
}
/\* 渲染到页面中 \*/
ReactDOM.render(<Title />, document.body )此时，就是添加了两个类，html结构如下图：
引入其它文件中的样式规则，写composes： className(要引入的类名) from '引入的文件路径即可'，最终效果同上，composes多少规则，就添加多少类。
最后：大家有名有发现，我一直都在类上做文章，那是因为CSS Modules只转换class名相关的样式。大家要注意啦。
在最后，给大家提供一个js库——classnames类库，给我的感觉和angular中的ng-class差不多，将值为true的类添加上。
