用法教程

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   

零、示例库

自身为那么些课程写了一个示例库,包罗四个德姆o。通过它们,你能够轻便学会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的如火如荼,其实不用是坏事,比如ES贰零壹肆的宣布和行使确实让自家感触到敲代码时候一点都不小的福利,比方箭头函数(笑)。但针锋相对来讲的,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)的语法,声Bellamy(Bellamy)个大局法则。凡是这样注解的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各样,以致ES2016原生都最早帮忙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)的语法,声美素佳儿个大局法则。凡是那样证明的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

本文由星彩网app下载发布于前端技术,转载请注明出处:用法教程

TAG标签:
Ctrl+D 将本页面保存为书签,全面了解最新资讯,方便快捷。