用法教程

CSS Modules 用法教程

2016/06/19 · CSS ·
亚洲必赢官网,Modules

初稿出处:
阮一峰   

学过网页开发就会清楚,CSS 不可以算编程语言,只是网页样式的一种描述方法。

为了让 CSS
也能适用软件工程措施,程序员想了各类措施,让它变得像一门编程语言。从最早的Less、SASS,到后来的
PostCSS,再到近年来的 CSS in JS,都是为了化解这些标题。

亚洲必赢官网 1

正文介绍的 CSS Modules
有所分化。它不是将 CSS
改造成编程语言,而是功效很单纯,只进入了有的效能域和模块依赖,那恰恰是网页组件最须求的功效。

据此,CSS Modules
很容命理术数,因为它的条条框框少,同时又极度有用,可以确保某个组件的样式,不会影响到任何零件。

亚洲必赢官网 2

webpack 之 css module

前者的升华太快了,以前拜读了一篇在 2016 年学 JavaScript
是一种什么的体会?,不禁慨叹,放一个三年前的前端来看待现在的前端圈子,揣度也是懵逼的。

CSS Modules 入门及 React 中实践

2017/03/25 · CSS ·
React

初稿出处:
AlloyTeam   

零、示例库

本人为那些科目写了一个示例库,包罗七个Demo。通过它们,你可以轻松学会CSS
Modules。

第一,克隆示例库。

JavaScript

$ git clone

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

然后,安装重视。

JavaScript

$ cd css-modules-demos $ npm install

1
2
$ cd css-modules-demos
$ npm install

继而,就可以运行第三个示范了。

JavaScript

$ npm run demo01

1
$ npm run demo01

开拓浏览器,访问

webpack配置
css-loader?modules
modules 字段表示开启css module

言归正传

自己取标题的能力也是挺瞎的……


引言吐槽了刹那间javascript的蓬勃发展,其实并非是坏事,例如ES2015的发布和选择确实让我感受到敲代码时候很大的方便,比如箭头函数(笑)。但针锋相对而言的,CSS的前进却并不是那么快。
可以想到的单独是各样预处理器

  • LESS
  • SASS
  • 以及后来比较盛行的postcss

只是她们如故没有缓解一个题材,命名的悲苦……

试想一下,一个大的种类,css命名满天飞,一不留神就覆盖了大局的class名如何是好?

** css究竟怎么了?**

  1. 大局污染
  2. 命名混乱
  3. 依傍管理不干净

写在前边

读文先看此图,能先有个大概概念:

亚洲必赢官网 3

读书本文必要 11m 24s。

一、局地成效域

CSS的规则都是全局的,任何一个组件的样式规则,都对所有页面有效。

发出一些成效域的绝无仅有形式,就是应用一个无比的class的名字,不会与其余接纳尊敬名。那就是
CSS Modules 的做法。

上边是一个React组件App.js。

JavaScript

import React from ‘react’; import style from ‘./App.css’; export default
() => { return ( <h1 className={style.title}> Hello World
</h1> ); };

1
2
3
4
5
6
7
8
9
10
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。

CSS

.title { color: red; }

1
2
3
.title {
  color: red;
}

构建工具会将类名style.title编译成一个哈希字符串。

XHTML

<h1 class=”_3zyde4l1yATCOkgn-DBWEL”> Hello World </h1>

1
2
3
<h1 class="_3zyde4l1yATCOkgn-DBWEL">
  Hello World
</h1>

App.css也会同时被编译。

JavaScript

._3zyde4l1yATCOkgn-DBWEL { color: red; }

1
2
3
._3zyde4l1yATCOkgn-DBWEL {
  color: red;
}

那样一来,那个类名就成为独一无二了,只对App组件有效。

用法教程。CSS Modules
提供各样插件,协理不一致的营造工具。本文使用的是
Webpack
的css-loader插件,因为它对
CSS Modules 的襄助最好,而且很容易选取。顺便说一下,假若您想学
Webpack,可以阅读我的学科Webpack-Demos。

上面是其一示例的webpack.config.js。

JavaScript

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” }, ] } };

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
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。

JavaScript

$ npm run demo01

1
$ npm run demo01

打开
,可以观看结果,h1标题突显为蓝色。

定制css类名规则
modules&localIdentName=[path][name]—[local]—[hash:base64:5]
localIdentName 字段定义css类名规则

怎么办,试试BEM呗

您还真别说,业界确实有一个卓殊不错的css命名规范,BEM(不开展了),有趣味的电动检索一下啊,BEM规范的好处在于尽可能的解决了css命名全局污染的标题。可是,它的平整真的太麻烦了,还不佳记。

举个例证

.block{} /* 块 */
.block__element{} /* 元素 */
.block--modifier{} /* 修饰符 */

什么都别说了……

CSS Modules介绍

CSS Modules是哪些事物呢?首先,让咱们从官方文档下手:
GitHub – css-modules/css-modules: Documentation about
css-modules

A CSS Module is a CSS file in which all class names and animation
names are scoped locally by default.
CSS模块就是独具的类名都只有一对功能域的CSS文件。

因而CSS
Modules既不是法定正式,也不是浏览器的表征,而是在创设步骤(例如利用Webpack或Browserify)中对CSS类名拔取器限定效率域的一种方法(通过hash已毕类似于命名空间的章程)。

It doesn’t really matter in the end (although shorter class names mean
shorter stylesheets) because the point is that they are dynamically
generated, unique, and mapped to the correct
styles.在行使CSS模块时,类名是动态变化的,唯一的,并精确对应到源文件中的各样类的体制。

那也是兑现样式功用域的规律。它们被限定在特定的沙盘里。例如大家在buttons.js里引入buttons.css文件,并使用.btn的体裁,在任何零件里是不会被.btn影响的,除非它也引入了buttons.css.

可大家是由于什么目标把CSS和HTML文件搞得那般零碎呢?大家为何要使用CSS模块呢?

二、全局成效域

CSS Modules
允许利用:global(.className)的语法,声可瑞康(Karicare)个大局规则。凡是这样注脚的class,都不会被编译成哈希字符串。

App.css加盟一个大局class。

JavaScript

.title { color: red; } :global(.title) { color: green; }

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

App.js采纳普通的class的写法,就会引用全局class。

JavaScript

import React from ‘react’; import styles from ‘./App.css’; export
default () => { return ( <h1 className=”title”> Hello World
</h1> ); };

1
2
3
4
5
6
7
8
9
10
import React from ‘react’;
import styles from ‘./App.css’;
 
export default () => {
  return (
    <h1 className="title">
      Hello World
    </h1>
  );
};

运行那些示例。

JavaScript

$ npm run demo02

1
$ npm run demo02

打开

CSS Modules
还提供一种显式的片段效率域语法:local(.className),等同于.className,所以地方的App.css也可以写成下边那样。

JavaScript

:local(.title) { color: red; } :global(.title) { color: green; }

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

引入:
import style from ‘./App.css’;
style.title{}

CSS modules来了

要说js模块化,这几年真是讲烂了,什么速龙,CMD,UMD各样,以及ES2015原生都初步扶助js模块化。讲真,在自家起来接触了模块化js之后确实给自家带来了重重的惠及(点个赞)。
无异于,CSS module的带来或者也可能解决近来大家最咳嗽的CSS 全局污染难点了。

怎么大家需求CSS模块化

三、定制哈希类名

css-loader默许的哈希算法是[hash:base64],这会将.title编译成._3zyde4l1yATCOkgn-DBWEL那样的字符串。

webpack.config.js内部可以定制哈希字符串的格式。

JavaScript

module: { loaders: [ // … { test: /.css$/, loader:
“style-loader!css-loader?modules&localIdentName=[path][name]—[local]—[hash:base64:5]”
}, ] }

1
2
3
4
5
6
7
8
9
module: {
  loaders: [
    // …
    {
      test: /.css$/,
      loader: "style-loader!css-loader?modules&amp;localIdentName=[path][name]—[local]—[hash:base64:5]"
    },
  ]
}

运行那几个示例。

JavaScript

$ npm run demo03

1
$ npm run demo03

你会发现.title被编译成了demo03-components-App—title—GpMto。

全局:
:global()
eg:
:global(.title){}

CSS modules语法篇

一切从头前,要表示一下,CSS modules不是一个新语言,而只是CSS in
JS向来兑现格局,最值得尊重的是,它的条条框框越发少,大约0本金!那有的参考了阮一峰大神的CSS
Modules
用法教程

CSS全局功用域难题

CSS的平整都是大局的,任何一个零部件的体制规则,都对总体页面有效。相信写css的人都会遇上样式争持(污染)的标题。

于是一般这么做(小编都做过):
* class命名写长一点吗,下落争执的几率
* 加个父元素的选拔器,限制范围
* 重新命名个class吧,比较保障

由此亟待解决的题材就是css局地功效域幸免全局样式争持(污染)的标题

四、 Class 的组合

在 CSS Modules
中,一个接纳器可以持续另一个选取器的平整,那叫做”组合”(“composition”)。

在App.css中,让.title继承.className

JavaScript

.className { background-color: blue; } .title { composes: className;
color: red; }

1
2
3
4
5
6
7
8
.className {
  background-color: blue;
}
 
.title {
  composes: className;
  color: red;
}

App.js毫无修改。

JavaScript

import React from ‘react’; import style from ‘./App.css’; export default
() => { return ( <h1 className={style.title}> Hello World
</h1> ); };

1
2
3
4
5
6
7
8
9
10
import React from ‘react’;
import style from ‘./App.css’;
 
export default () => {
  return (
    <h1 className={style.title}>
      Hello World
    </h1>
  );
};

运作那些示例。

JavaScript

$ npm run demo04

1
$ npm run demo04

打开

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

JavaScript

._2DHwuiHWMnKTOYG45T0x34 { color: red; } ._10B-buq6_BEOTOl9urIjf8 {
background-color: blue; }

1
2
3
4
5
6
7
._2DHwuiHWMnKTOYG45T0x34 {
  color: red;
}
 
._10B-buq6_BEOTOl9urIjf8 {
  background-color: blue;
}

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

class组合:
composes:classname;

1. 局地效用域

简短,使用CSS modules ,每一个class都足以生成一个唯一的class名

例如
创制一个button.css文件,并写入代码

.red{
   color:red  
}

引入到另一个index.js(省略了一有的代码)

import buttons from "./buttons.css";
element.innerHTML = `<div class="${buttons.red}">`

那就是说,在渲染到html文件之中的时候,这里的class可能就是_3N_PGYCwi_3X8rf_WN50yo(命名规则其实是可以活动调整的,上边会提到)

JS CSS不可能共享变量

复杂组件要使用 JS 和 CSS 来共同处理体制,就会招致有些变量在 JS 和 CSS
中冗余,CSS预处理器/后甩卖器 等都不提供跨 JS 和 CSS 共享变量那种力量。

五、输入任何模块

选拔器也得以继续其余CSS文件之中的条条框框。

another.css

JavaScript

.className { background-color: blue; }

1
2
3
.className {
  background-color: blue;
}

App.css可以继承another.css里面的平整。

JavaScript

.title { composes: className from ‘./another.css’; color: red; }

1
2
3
4
.title {
  composes: className from ‘./another.css’;
  color: red;
}

运作这些示例。

JavaScript

$ npm run demo05

1
$ npm run demo05

打开

引入其他模块:
composes: classname from ’./style.css’;

2. 大局功效域

CSS Modules
允许利用:global(.className)的语法,声澳优(Ausnutria Hyproca)(Beingmate)个大局规则。凡是那样注明的class,都不会被编译成哈希字符串。

.title { color: red;}
:global(.title) { color: green;}

首个渲染的class依旧是.title

CSS Modules
还提供一种显式的有的功用域语法:local(.className),等同于.class,所以上述的css文件也可以写成上边那样。

:local(.title) { color: red;}
:global(.title) { color: green;}

年富力强并且扩充方便的CSS

用作有追求的工程师,编写健壮并且扩充方便的CSS平昔是大家的靶子。那么什么样定义健壮并且伸张方便?有八个要点:

  • 面向组件 – 处理 UI 复杂性的最佳实践就是将 UI 分割成一个个的小组件
    Locality_of_reference
    。即使您正在使用一个理所当然的框架,JavaScript
    方面就将原生帮助(组件化)。举个例子,React
    就鼓励中度组件化和分叉。我们希望有一个 CSS 架构去匹配。
  • 沙箱化(Sandboxed) –
    倘若一个零件的体裁会对其他零件暴发不须求以及意外的震慑,那么将
    UI
    分割成组件并从未怎么用。就那下边而言,CSS的大局意义域会给你造成负担。
  • 便宜 –
    大家想要所有好的事物,并且不想发出更多的行事。也就是说,大家不想因为使用那些架构而让大家的开发者体验变得更糟。可能的话,大家想开发者体验变得更好。

六、输入变量

CSS Modules 协理选用变量,然而须要设置 PostCSS 和
postcss-modules-values。

JavaScript

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

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

把postcss-loader加入webpack.config.js。

JavaScript

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 ] };

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
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其间定义变量。

JavaScript

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

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

App.css可以引用那一个变量。

JavaScript

@value colors: “./colors.css”; @value blue, red, green from colors;
.title { color: red; background-color: blue; }

1
2
3
4
5
6
7
@value colors: "./colors.css";
@value blue, red, green from colors;
 
.title {
  color: red;
  background-color: blue;
}

运转那个示例。

JavaScript

$ npm run demo06

1
$ npm run demo06

打开

1 赞 3 收藏
评论

亚洲必赢官网 4

引入变量:(postcss-loader ;postcss-modules-values)

3. 定制哈希类名

相当webpack食用更佳
举个同盟webpack使用的例子

//webpack.config.js文件
……
module: { 
loaders: [  // ... 
{ 
 test: /\.css$/, 
 loader: "style-loader!css-loader?modules&localIdentName=[path][name]---[local]---[hash:base64:5]" },
]
}

如故是上边的事例
创造一个button.css文件,并写入代码

.red{
   color:red  
}

那么,渲染的class可能是 .buttons__red___3N_PG

CSS模块化方案分类

CSS 模块化的解决方案有广大,但紧要有三类。

  1. web pack配置增添 postcss: [require(‘postcss-modules-values’) ]
  2. 语法(注意‘: ’ 号后空格,去掉会报错!)
    @value green: #aaf200; 定义变量
    @value colors: “./colors.css”;
    @value blue, red, green from colors;
4. Class 的组合

在 CSS Modules
中,一个接纳器可以持续另一个拔取器的条条框框,这名叫”组合”(”composition”)。

平昔上代码
成立一个button.css文件,并写入代码

.red{
   color:red  
}
.button{
  composes:red
}

应用composes继承了class名为red的特性,有点类似于sass里面的@extend。

其余还接济多个模块的引入
例如
创办一个button.css文件,并写入代码

.red{
   color:red  
}

同目录创立一个button2.css文件,并写入代码

.button{
  composes:red from './button.css'
}

通过** composes:red from ‘./button.css’**落实了五个公文之间的组成。

CSS 命名约定

规范化CSS的模块化解决方案(比如BEM BEM — Block Element
Modifier,OOCSS,AMCSS,SMACSS,SUITCSS)
但存在以下难点:
* JS CSS之间照旧没有挖掘变量和拔取器等
* 复杂的命名

5. 输入变量

接触不多,具体贯彻详见原文。

CSS in JS

绝望摒弃 CSS,用 JavaScript 写 CSS 规则,并内联样式。 React: CSS in JS
// Speaker
Deck。Radium,react-style
属于这一类。但存在以下难题:
* 不能使用伪类,媒体询问等
* 样式代码也见面世大量重复。
* 不能应用成熟的 CSS 预处理器(或后电脑)

CSS modules 使用实例

*此处运用 webpack *

类型布局

  • src (文件夹)
  • node_modules (文件夹)
  • .babelrc
  • index.html
  • webpack.config.js
  • package.json

若是项目标文书夹是 app, 在app文件夹内npm init 生成 package.json
文件
然后(请确认已全局安装webpack),
npm install -D babel-core babel-loader babel-preset-es2015 extract-text-webpack-plugin css-loader webpack

在webpack.config.js中写入以下内容

var path = require('path')
var ExtractTextPlugin = require("extract-text-webpack-plugin");

module.exports = {
    entry: './src',
    output: {
        path: 'bulid',
        filename: 'bundle.js'
    },
    module: {
        loaders: [{
            test: /\.js$/,
            loader: 'babel-loader',
            include: path.resolve(__dirname, './src')
        }, {
            test: /\.css$/,
            loader: ExtractTextPlugin.extract('css?modules&importLoaders=1&localIdentName=[name]__[local]___[hash:base64:5]'),
            include: path.resolve(__dirname, 'src'),
        }]
    },
    plugins: [
        new ExtractTextPlugin("styles.css")
    ],
    devtool: "source-map"
}

在.babelrc文件中写入

{
 "presets": ["es2015"]
}```

在index.html中写入

<!DOCTYPE html>
<html lang=”en”>
<head>
<meta charset=”UTF-8″>
<title>Document name</title>
<link rel=”stylesheet” href=”bulid/styles.css”>
</head>
<body>
<h1>CSS Modules demo</h1>

<script src="bulid/bundle.js"></script>

</body>
</html>

准备工作做完,我们在src文件夹中进行具体的内容操作

###### step1 
在src中新建 index.js,内容

import buttons from ‘./buttons.css’

let element =
<div class="${buttons.red}"> <p>Lorem ipsum dolor sit amet, consectetur adipisicing elit. Consequatur laudantium recusandae itaque libero velit minus ex reiciendis veniam. Eligendi modi sint delectus beatae nemo provident ratione maiores, voluptatibus a tempore!</p> </div>;
document.write(element);

###### setp2 
在src文件夹中新建buttons.css,内容

.red{
color:red
}

###### setp3 
在命令行中执行webpack任务,生成bulid文件夹。

命令行 输入   ```webpack``` 尝试一下吧!!
***
在上述的项目中,css modules的核心是webpack.config.js中 

{
test: /.css$/,
loader:
ExtractTextPlugin.extract(‘css?modules&importLoaders=1&localIdentName=[name][local]_[hash:base64:5]’),
include: path.resolve(__dirname, ‘src’),
}

# 文章参考
[CSS Modules入门Ⅰ:它是什么?为什么要使用它?
](https://zhuanlan.zhihu.com/p/23571898)
[CSS Modules入门Ⅱ:快速上手](https://zhuanlan.zhihu.com/p/23602046)
[CSS Modules 用法教程](http://www.bshare.cn/share)

运用JS 来治本体制模块

使用JS编译原生的CSS文件,使其负有模块化的能力,代表是 CSS Modules
GitHub – css-modules/css-modules: Documentation about
css-modules 。

CSS Modules 能最大化地构成现有 CSS 生态(预处理器/后电脑等)和 JS
模块化能力,大约零就学开销。只要你使用
Webpack,可以在其他项目中接纳。是作者觉得近年来最好的 CSS 模块化解决方案。

CSS Modules 使用教程

启用 CSS Modules

JavaScript

// webpack.config.js
css?modules&localIdentName=[name]__[local]-[hash:base64:5]

1
2
// webpack.config.js
css?modules&localIdentName=[name]__[local]-[hash:base64:5]

加上 modules 即为启用,localIdentName 是设置生成样式的命名规则。

CSS

/* components/Button.css */ .normal { /* normal 相关的具备样式 */ }

1
2
/* components/Button.css */
.normal { /* normal 相关的所有样式 */ }

JavaScript

// components/Button.js import styles from ‘./Button.css’;
console.log(styles); buttonElem.outerHTML = `<button
class=${styles.normal}>Submit</button>`

1
2
3
4
// components/Button.js
import styles from ‘./Button.css’;
console.log(styles);
buttonElem.outerHTML = `<button class=${styles.normal}>Submit</button>`

生成的 HTML 是

XHTML

<button class=”button–normal-abc53″>Submit</button>

1
<button class="button–normal-abc53">Submit</button>

注意到 button--normal-abc53 是 CSS Modules 按照 localIdentName
自动生成的 class 名。其中的abc53
是根据给定算法生成的连串码。经过如此模糊处理后,class
名基本就是绝无仅有的,大大下降了项目中样式覆盖的几率。同时在生育环境下修改规则,生成更短的
class 名,可以增加 CSS 的压缩率。

上例中 console 打印的结果是:

CSS

Object {   normal: ‘button–normal-abc53’,   disabled:
‘button–disabled-def886’, }

1
2
3
4
Object {
  normal: ‘button–normal-abc53’,
  disabled: ‘button–disabled-def886’,
}

CSS Modules 对 CSS 中的 class 名都做了拍卖,使用对象来保存原 class
和混淆后 class 的相应关系。

经过那几个概括的拍卖,CSS Modules 完毕了以下几点:
* 所有样式都是一些功能域 的,解决了全局污染难题
* class 名生成规则配置灵活,可以此来压缩 class 名
* 只需引用组件的 JS 就能搞定组件所有的 JS 和 CSS
* 依旧是 CSS,大致 0 学习开支

CSS Modules 在React中的实践

那就是说大家在React中怎么利用?

手动引用解决

className 处直接采取 css 中 class 名即可。

JavaScript

import React from ‘react’; import styles from ‘./table.css’;   export
default class Table extends React.Component {     render () {
        return <div className={styles.table}>             <div
className={styles.row}>             </div>
        </div>;     } }

1
2
3
4
5
6
7
8
9
10
11
import React from ‘react’;
import styles from ‘./table.css’;
 
export default class Table extends React.Component {
    render () {
        return <div className={styles.table}>
            <div className={styles.row}>
            </div>
        </div>;
    }
}

渲染出来的机件出来

XHTML

<div class=”table__table___32osj”>     <div
class=”table__row___2w27N”>     </div> </div>

1
2
3
4
<div class="table__table___32osj">
    <div class="table__row___2w27N">
    </div>
</div>

react-css-modules

一经你不想频仍的输入 styles.**,有一个 GitHub –
gajus/react-css-modules: Seamless mapping of class names to CSS modules
inside of React
components.,它经过高阶函数的方式来扭转className,可是不引进使用,后文种提到。

API也很粗略,给组件外包一个CSSModules即可。

JavaScript

import React from ‘react’; import CSSModules from ‘react-css-modules’;
import styles from ‘./table.css’;   class Table extends React.Component
{     render () {         return <div styleName=’table’>
        </div>;     } }   export default CSSModules(Table,
styles);

1
2
3
4
5
6
7
8
9
10
11
12
import React from ‘react’;
import CSSModules from ‘react-css-modules’;
import styles from ‘./table.css’;
 
class Table extends React.Component {
    render () {
        return <div styleName=’table’>
        </div>;
    }
}
 
export default CSSModules(Table, styles);

但是那样大家可以看来,它是索要周转时的看重,而且须求在运作时才取得className,性能损耗大,那么有没有便宜又就像是无损的法子呢?答案是一对,使用babel插件babel-plugin-react-css-modulesGitHub
– gajus/babel-plugin-react-css-modules: Transforms styleName to
className using compile time CSS module
resolution.
className得到前置到编译阶段。

babel-plugin-react-css-modules

babel-plugin-react-css-modules
可以兑现应用styleName品质自动加载CSS模块。大家透过该babel插件来开展语法树解析并最终身成className

来看望组件的写法,现在你只需求把className换成styleName即可取得CSS局地功用域的力量了,是否极度简单。

JavaScript

import React from ‘react’; import styles from ‘./table.css’;   class
Table extends React.Component {     render () {         return <div
styleName=’table’>         </div>;     } }   export default
Table;

1
2
3
4
5
6
7
8
9
10
11
import React from ‘react’;
import styles from ‘./table.css’;
 
class Table extends React.Component {
    render () {
        return <div styleName=’table’>
        </div>;
    }
}
 
export default Table;

做事原理

这就是说该babel插件是怎么工作的啊?让我们从官方文档出手:

GitHub – gajus/babel-plugin-react-css-modules: Transforms styleName to
className using compile time CSS module
resolution.

小编不才 ,稍作翻译如下:
1.
创设每个文件的拥有样式表导入的目录(导入具有.css.scss增加名的公文)。

  1. 使用postcss
    解析匹配到的css文件
  2. 遍历所有
    JSX
    元素讲明
  3. styleName 属性解析成匿名和命名的局地css模块引用
  4. 摸索与CSS模块引用相匹配的CSS类名称:
    * 如果styleName的值是一个字符串字面值,生成一个字符串字面值。
    *
    如果是JSXExpressionContainer,在运行时拔取helper函数来打造假如styleName的值是一个jSXExpressionContainer,
    使用匡助函数([getClassName]在运转时社团className值。
  5. 从要素上移除styleName属性。
    7.
    将转变的className累加到现有的className值中(倘诺不设有则创造className属性)。

使用实例

在成熟的档次中,一般都会用到CSS预处理器或者后电脑。

此地以利用了stylusCSS预处理器为例子,咱们来看下怎么样使用。

  • 安装依赖

Shell

npm install -save-dev sugerss babel-plugin-react-css-modules

1
npm install -save-dev sugerss babel-plugin-react-css-modules
  • 编写Webpack配置
JavaScript

// webpack.config.js module: {   loaders: \[{     test: /\\.js?$/,
    loader: \[\['babel-plugin-react-css-modules',{
          generateScopedName:'\[name\]\_\_\[local\]',
          filetypes: {               ".styl": "sugerss"            }
     }\]\]   }, {     test: /\\.module.styl$/,     loader:
'style!css?modules&localIdentName=\[name\]\_\_\[local\]!styl?sourceMap=true'
  }, {     test: /\\.styl$/,     loader:
'style!css!styl?sourceMap=true'   }\] }

<table>
<colgroup>
<col style="width: 50%" />
<col style="width: 50%" />
</colgroup>
<tbody>
<tr class="odd">
<td><div class="crayon-nums-content" style="font-size: 13px !important; line-height: 15px !important;">
<div class="crayon-num" data-line="crayon-5b8f6729d9ed4116610999-1">
1
</div>
<div class="crayon-num crayon-striped-num" data-line="crayon-5b8f6729d9ed4116610999-2">
2
</div>
<div class="crayon-num" data-line="crayon-5b8f6729d9ed4116610999-3">
3
</div>
<div class="crayon-num crayon-striped-num" data-line="crayon-5b8f6729d9ed4116610999-4">
4
</div>
<div class="crayon-num" data-line="crayon-5b8f6729d9ed4116610999-5">
5
</div>
<div class="crayon-num crayon-striped-num" data-line="crayon-5b8f6729d9ed4116610999-6">
6
</div>
<div class="crayon-num" data-line="crayon-5b8f6729d9ed4116610999-7">
7
</div>
<div class="crayon-num crayon-striped-num" data-line="crayon-5b8f6729d9ed4116610999-8">
8
</div>
<div class="crayon-num" data-line="crayon-5b8f6729d9ed4116610999-9">
9
</div>
<div class="crayon-num crayon-striped-num" data-line="crayon-5b8f6729d9ed4116610999-10">
10
</div>
<div class="crayon-num" data-line="crayon-5b8f6729d9ed4116610999-11">
11
</div>
<div class="crayon-num crayon-striped-num" data-line="crayon-5b8f6729d9ed4116610999-12">
12
</div>
<div class="crayon-num" data-line="crayon-5b8f6729d9ed4116610999-13">
13
</div>
<div class="crayon-num crayon-striped-num" data-line="crayon-5b8f6729d9ed4116610999-14">
14
</div>
<div class="crayon-num" data-line="crayon-5b8f6729d9ed4116610999-15">
15
</div>
<div class="crayon-num crayon-striped-num" data-line="crayon-5b8f6729d9ed4116610999-16">
16
</div>
<div class="crayon-num" data-line="crayon-5b8f6729d9ed4116610999-17">
17
</div>
<div class="crayon-num crayon-striped-num" data-line="crayon-5b8f6729d9ed4116610999-18">
18
</div>
</div></td>
<td><div class="crayon-pre" style="font-size: 13px !important; line-height: 15px !important; -moz-tab-size:4; -o-tab-size:4; -webkit-tab-size:4; tab-size:4;">
<div id="crayon-5b8f6729d9ed4116610999-1" class="crayon-line">
// webpack.config.js
</div>
<div id="crayon-5b8f6729d9ed4116610999-2" class="crayon-line crayon-striped-line">
module: {
</div>
<div id="crayon-5b8f6729d9ed4116610999-3" class="crayon-line">
  loaders: [{
</div>
<div id="crayon-5b8f6729d9ed4116610999-4" class="crayon-line crayon-striped-line">
    test: /\.js?$/,
</div>
<div id="crayon-5b8f6729d9ed4116610999-5" class="crayon-line">
    loader: [['babel-plugin-react-css-modules',{
</div>
<div id="crayon-5b8f6729d9ed4116610999-6" class="crayon-line crayon-striped-line">
          generateScopedName:'[name]__[local]',
</div>
<div id="crayon-5b8f6729d9ed4116610999-7" class="crayon-line">
          filetypes: {
</div>
<div id="crayon-5b8f6729d9ed4116610999-8" class="crayon-line crayon-striped-line">
              &quot;.styl&quot;: &quot;sugerss&quot;
</div>
<div id="crayon-5b8f6729d9ed4116610999-9" class="crayon-line">
           }
</div>
<div id="crayon-5b8f6729d9ed4116610999-10" class="crayon-line crayon-striped-line">
     }]]
</div>
<div id="crayon-5b8f6729d9ed4116610999-11" class="crayon-line">
  }, {
</div>
<div id="crayon-5b8f6729d9ed4116610999-12" class="crayon-line crayon-striped-line">
    test: /\.module.styl$/,
</div>
<div id="crayon-5b8f6729d9ed4116610999-13" class="crayon-line">
    loader: 'style!css?modules&amp;localIdentName=[name]__[local]!styl?sourceMap=true'
</div>
<div id="crayon-5b8f6729d9ed4116610999-14" class="crayon-line crayon-striped-line">
  }, {
</div>
<div id="crayon-5b8f6729d9ed4116610999-15" class="crayon-line">
    test: /\.styl$/,
</div>
<div id="crayon-5b8f6729d9ed4116610999-16" class="crayon-line crayon-striped-line">
    loader: 'style!css!styl?sourceMap=true'
</div>
<div id="crayon-5b8f6729d9ed4116610999-17" class="crayon-line">
  }]
</div>
<div id="crayon-5b8f6729d9ed4116610999-18" class="crayon-line crayon-striped-line">
}
</div>
</div></td>
</tr>
</tbody>
</table>

  • 组件写法

JavaScript

import React from ‘react’; import ‘./table.module.styl’;   class Table
extends React.Component {     render () {         return <div
styleName=’table’>         </div>;     } }   export default
Table;

1
2
3
4
5
6
7
8
9
10
11
import React from ‘react’;
import ‘./table.module.styl’;
 
class Table extends React.Component {
    render () {
        return <div styleName=’table’>
        </div>;
    }
}
 
export default Table;

如上,你可以透过配备Webpack中module.loaders的test路径Webpack-module-loaders-configuration,来区分样式文件是还是不是须要CSS模块化。
搭配sugerss这个postcss插件作为stylus的语法加载器,来支撑babel插件babel-plugin-react-css-modules的语法解析。

末段大家回过头来看下,我们React组件只必要把className换成styleName,搭配以上营造配置,即可落成CSS模块化

最后

CSS Modules 很好的化解了 CSS 方今面临的模块化难点。帮助与
CSS处理器搭配使用,能丰富利用现有技术积累。若是您的制品中恰恰遇见类似题材,相当值得一试。

期望大家都能写出健康并且可扩展的CSS,以上。

1 赞 2 收藏
评论

亚洲必赢官网 5

网站地图xml地图