阮一峰:CSS Modules 用法教程

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

为了让 CSS 也能适用软件工程方法,程序员想了各种办法,让它变得像一门编程语言。从最早的Less、SASS,到后来的 PostCSS,再到最近的 CSS in JS,都是为了解决这个问题。

本文介绍的 CSS Modules 有所不同。它不是将 CSS 改造成编程语言,而是功能很单纯,只加入了局部作用域和模块依赖,这恰恰是网页组件最急需的功能。

因此,CSS Modules 很容易学,因为它的规则少,同时又非常有用,可以保证某个组件的样式,不会影响到其他组件。

零、示例库

我为这个教程写了一个示例库,包含六个Demo。通过它们,你可以轻松学会CSS Modules。

首先,克隆示例库。

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

然后,安装依赖。

$cdcss-modules-demos$ npminstall

接着,就可以运行第一个示例了。

$ npm run demo01

打开浏览器,访问http://localhost:8080,查看结果。其他示例的运行方法类似。

一、局部作用域

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

产生局部作用域的唯一方法,就是使用一个独一无二的class的名字,不会与其他选择器重名。这就是 CSS Modules 的做法。

下面是一个React组件App.js

importReactfrom'react';importstylefrom'./App.css';exportdefault()=>{return(<h1 className={style.title}>Hello World</h1>);};

上面代码中,我们将样式文件App.css输入到style对象,然后引用style.title代表一个class。

.title{color:red;}

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

<h1class="_3zyde4l1yATCOkgn-DBWEL">Hello World</h1>

App.css也会同时被编译。

._3zyde4l1yATCOkgn-DBWEL{color:red;}

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

CSS Modules 提供各种插件,支持不同的构建工具。本文使用的是 Webpack 的css-loader插件,因为它对 CSS Modules 的支持最好,而且很容易使用。顺便说一下,如果你想学 Webpack,可以阅读我的教程Webpack-Demos

下面是这个示例的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 功能。

现在,运行这个Demo。

$ npm run demo01

打开 http://localhost:8080 ,可以看到结果,h1标题显示为红色。

二、全局作用域

CSS Modules 允许使用:global(.className)的语法,声明一个全局规则。凡是这样声明的class,都不会被编译成哈希字符串。

App.css加入一个全局class。

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

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

importReactfrom'react';importstylesfrom'./App.css';exportdefault()=>{return(<h1 className="title">Hello World</h1>);};

运行这个示例。

$ npm run demo02

打开 http://localhost:8080,应该会看到h1标题显示为绿色。

CSS Modules 还提供一种显式的局部作用域语法:local(.className),等同于.className,所以上面的App.css也可以写成下面这样。

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

三、定制哈希类名

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

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

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

运行这个示例。

$ npm run demo03

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

四、 Class 的组合

在 CSS Modules 中,一个选择器可以继承另一个选择器的规则,这称为”组合”(“composition”)。

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

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

App.js不用修改。

importReactfrom'react';importstylefrom'./App.css';exportdefault()=>{return(<h1 className={style.title}>Hello World</h1>);};

运行这个示例。

$ npm run demo04

打开http://localhost:8080,会看到红色的h1在蓝色的背景上。

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

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

相应地, h1的class也会编译成<h1 class="_2DHwuiHWMnKTOYG45T0x34 _10B-buq6_BEOTOl9urIjf8">。

五、输入其他模块

选择器也可以继承其他CSS文件里面的规则。

another.css

.className{background-color:blue;}

App.css可以继承another.css里面的规则。

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

运行这个示例。

$ npm run demo05

打开http://localhost:8080,会看到蓝色的背景上有一个红色的h1。

六、输入变量

CSS Modules 支持使用变量,不过需要安装 PostCSS 和 postcss-modules-values

$ npminstall--save postcss-loader postcss-modules-values

把postcss-loader加入webpack.config.js

varvalues=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里面定义变量。

@valueblue:#0c77f8;@valuered:#ff0000;@valuegreen:#aaf200;

App.css可以引用这些变量。

@valuecolors:"./colors.css";@valueblue, red, green from colors;.title{color:red;background-color:blue;}

运行这个示例。

$ npm run demo06

打开http://localhost:8080,会看到蓝色的背景上有一个红色的h1。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,372评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,368评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,415评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,157评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,171评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,125评论 1 297
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,028评论 3 417
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,887评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,310评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,533评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,690评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,411评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,004评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,659评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,812评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,693评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,577评论 2 353