用法教程
分类:前端技术

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

前端的开辟进取太快了,此前拜读了一篇在 二零一四 年学 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的旭日东升,其实毫不是帮倒忙,比如ES2016的宣布和使用确实让自家感受到敲代码时候十分的大的有利,比如箭头函数(笑)。但相对来讲的,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 作用。

近来,运转这些德姆o。

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)的语法,声贝因美(Dumex)个大局法规。凡是那样注解的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模块化,最近几年就是讲烂了,什么Intel,CMD,UMD各样,以致ES贰零壹伍原生都起来辅助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)(Aptamil)个大局法则。凡是那样表明的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 预管理器(或后Computer)

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 生态(预管理器/后Computer等)和 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预管理器也许后Computer。

这里以利用了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

本文由pc28.am发布于前端技术,转载请注明出处:用法教程

上一篇:前端项目支出流程及本事选型,前端工程 下一篇:没有了
猜你喜欢
热门排行
精彩图文
  • 用法教程
    用法教程
    CSS Modules 用法教程 2016/06/19 · CSS ·Modules 初藳出处:阮一峰    学过网页开拓就能知晓,CSS 无法算编程语言,只是网页样式的一种描述方法。 为了让 CSS也
  • 最基本的多少个概念,面试希图之CSS
    最基本的多少个概念,面试希图之CSS
    CSS 最核心的几个概念 2015/08/26 · CSS · 5评论 ·CSS 原文出处:GeekPlux    本文将讲述 CSS中最核心的几个概念,包括:盒模型、position、float等。这些是 CSS的基
  • 详解HTML5中rel属性的prefetch预加载功效接纳,前端
    详解HTML5中rel属性的prefetch预加载功效接纳,前端
    前端质量优化 – 能源预加载 2015/11/19 · JavaScript· 预加载 原著出处: ROBINRENDLE   译文出处:bubkoo的博客(@问崖的崖)    当提到前端质量优化时,我们
  • 又不理解怎么命名class了
    又不理解怎么命名class了
    怎么样鬼,又不驾驭怎么命名class了 2015/10/25 · CSS ·class 原稿出处:结一(@结一w3cplus)    信任写css的人都会遇见下边的标题:  糟糕,怎么命名这一个
  • 在行内元素前注入一个换行,right的使用说明
    在行内元素前注入一个换行,right的使用说明
    在行内元素前注入一个换行 2016/06/28 · CSS ·行内元素 原文出处: ChrisCoyier   译文出处:众成翻译    我遇到了一个小问题,我有一个 span 在 header 中,而