简单明了带你了解CSS Modules
层叠样式表
我们知道,css的全名叫做层叠样式表,这个“层叠”到底是什么意思呢?
有一种解释是,如果你先写了一条样式规则(选手1):
.title { color: silver; }
然后又在后边写了一条类似的(选手2):
.title { color: gold; }
因为名字相同,选手2就会和选手1打起来(让你丫冒充我!)。结果是选手2获胜,class名为title的元素,最终的color值为gold。
css里就像这样,随时可能一言不和就发生战争,结果输掉的一方就会被胜利的一方所覆盖。“层叠”一词可以说形象地描述了这个过程。
那么,为什么会有这样的层叠(zhàn zhēng )呢?
css的作用域问题
在javascript里,可以做到这样的搭配:
var title = "silver"; (function(){ var title = "gold"; console.log(title); // gold }()); console.log(title); // silver
利用javascript的函数作用域,两位同样名为title的选手可以友好相处。
但回到css里的样式规则,情况就完全不是这么回事了。
css不是程序语言,但如果说要给它加一个作用域的概念的话,那就是:只有全局作用域。
无论分拆为多少个css文件,无论用怎样的方式引入,所有的样式规则都位于同一作用域,只要选择符近似,就有发生覆盖的可能。
减少相互影响的策略
为减少相互影响,避免预料之外的样式覆盖,我们一直以来想过很多办法。
比如你接手一个别人留下来的旧项目,接下来要新增一个标题元素的时候,你会有意识地不去使用.title这样模糊的class名,因为它太容易重名了。最终,你用的名称可能是:
.module-sp-title { color: deepskyblue; }
即使你决定要用.title这个名字,你也会加上包含选择符作为限定:
.module-1 .title { font-size: 18px; } /* ... */ .module-2 .title { font-size: 14px; }
其中.module-1和.module-2的名字应该是唯一的,这样的代码在组件化(模块化)的开发风格里很常见。
此外,一些有名的css理论,如smacss,会建议你为所有布局样式使用l-或layout-的前缀,以示区分。
类似的做法还有很多,但归结起来,都是在尝试提供一种合理的命名约定。而合理的命名约定,的确是组织css代码的有效策略。
现在,我们有了新的可用策略,css modules就是其中之一。
技术流的模块化
css modules是一种技术流的组织css代码的策略,它将为css提供默认的局部作用域。
css modules是如何做到的呢?来看一个css modules的简单例子吧。
有这样的一个html元素:
<h2 id="example_title" class="title">a title for css modules</h2>
按照普通css的写法,我们可以这样为它添加样式:
.title { background-color: snow; }
现在我们改用css modules。首先,css保持不变。然后,修改html的写法。不再这样直接写html,而是改为在javascript文件里动态添加,这样做(css文件名为main.css):
var styles = require("./main.css"); var el = document.getelementbyid("example_title"); el.outerhtml = '<h2 class="' + styles.title + '">a title for css modules</h2>';
咦,require了一个css文件?对的,所以要用到webpack。编译后,html和css会变成这样:
看到这样不太美观的class名你大概就明白了,css modules无法改变css全局作用域的本性,它是依靠动态生成class名这一手段,来实现局部作用域的。显然,这样的class名就可以是唯一的,不管原本的css代码写得有多随便,都可以这样转换得到不冲突的css代码。
模拟的局部作用域也没有关系,它是可靠的。
这个css modules的例子说完了,但你一定跟我最初看到的时候一样有很多问题。
css modules的应用细节
如何启用css modules
“webpack编译css我也用过,怎么我用的时候不长这样?”
一般来说,require一个css文件的写法是:
require("./main.css");
但在前面的例子中,用了var styles = require("./main.css");的写法。这就好像是在说,我要这个css文件里的样式是局部的,然后我根据需要自行取用。
在项目里应用css modules有很多方法,目前比较常用的是使用webpack的css-loader。在webpack配置文件里写css-loader?modules就可以开启css modules,例如前面的例子所用的:
module: { loaders: [{ test: /\.css$/, loader: 'style!css?modules' }] }
才发现一直用着的css-loader原来有这功能?其实,css modules确实是一个后来才并入css-loader的新功能。
自定义生成的class名
“
名字都这样了,还怎么调试?”
为css-loader增加localidentname参数,是可以指定生成的名字。localidentname的默认值是[hash:base64],一般开发环境建议用类似这样的配置:
{ test: /\.css$/, loader: 'style!css?modules&localidentname=[name]__[local]___[hash:base64:5]' }
同样应用到前面的例子里,这时候就会变成这样的结果:
这样是不是要有意义多了?
如果是线上环境,可以考虑用更短的名字进一步减小css文件大小。
css modules下的html
(看了前面例子里的el.outerhtml = ...后)
“什么,outerhtml?class名还要拼接?你家html才这么写呢!”
很遗憾,css modules官方的例子,也是这个意思:要使用css modules,必须想办法把变量风格的class名注入到html中。也就是说,html模板系统是必需的,也正是如此,相比普通css的情况,css modules的html写起来要更为费劲。
如果你搜一下css modules的demo,可以发现大部分都是基于react的。显然,虚拟dom风格的react,搭配css modules会很容易(es6):
import styles from './scopedselectors.css'; import react, { component } from 'react'; export default class scopedselectors extends component { render() { return ( <div classname={ styles.root }> <p classname={ styles.text }>scoped selectors</p> </div> ); } };
如果不使用react,还是那句话,只要有办法把变量风格的class名注入到html中,就可以用css modules。原始的字符串拼接的写法显然很糟糕,但我们可以借助各种模板引擎和编译工具做一些改进。下面请看一个用jade的参考示例。
想象一下你有一个用普通css的页面,但你想在一小块区域使用css modules。这一块区域在一个容器元素里:
<div id="module_sp_container"></div>
后用jade来写html(关联的css文件为module_sp.css):
- styles = require("./module_sp.css"); h2(class=styles.title) a title for css modules
接下来,仍然是在javascript里添加这段jade生成的html:
var el = document.getelementbyid("module_sp_container"); var template = require("./main.jade"); el.innerhtml = template();
最后,记得在css-loader启用css modules的同时,增加jade-loader:
{ test: /\.jade$/, loader: 'jade' }
编译运行,就可以得到想要的结果。除jade以外,还有些其他css modules的html应用方案,推荐参考github上的这篇issue。
目前css modules还在发展中,而且也在考虑改进css modules下的html写作体验。css modules团队成员有提到一个叫css modules injector的未来规划项目,目的是让开发者不用javascript也可以使用css modules(这就很接近原生html + css的组合了)。
css modules下的样式复用
“样式都是唯一的了,怎么复用?”
我们已经说了挺多普通css单个全局作用域的坏处。但对应的,这也有一个很大的好处,就是便于实现样式的复用。css理论oocss也是在追求这一点。
css modules提供一个composes方法用于样式复用。例如,你有一个btn.css里有一条:
.btn{ display: inline-block; }
然后,你在另一个css module的module_sp.css里可以这样引入它:
.btn-sp{ composes: btn from "./btn.css"; font-size: 16px; }
那么,这个div.btn-sp的dom元素将会是:
可以看到,composes的用法比较类似sass的@extend,但不同于@extend的是,composes并不增加css里的选择符总量,而是采用组合多个class名的形式。在这个例子里,原本仅有1个class的div.btn-sp,变成了2个class。
因此,css modules建议只使用1个class就定义好对应元素所需的全部样式。它们会再由css modules转换为适当的class组合。
css modules团队成员认为composes是css modules里最强大的功能:
for me, the most powerful idea in css modules is composition, where you can deconstruct your visual inventory into atomic classes, and assemble them at a module level, without duplicating markup or hindering performance.
更详细的composes的用法及其理解,推荐阅读css modules: welcome to the future。
其他可能有用的补充
和已有的普通css共存
很多项目会引入bootstrap、materialize等框架,它们是普通的、全局的css。此外,你也可能自己会写一些普通css。如何共存呢?css modules团队成员对此提到过:
a css module should only import information relative to it
意思是,建议把css modules看做一种新的css,和原来的普通css区分开来。比如,composes的时候,不要从那些普通的css里去取。
在css-loader里通过指定test、include、exclude来区分它们。保持css modules的纯净,只有想要应用css modules的css文件,才启用css modules。
只转换class和id
经过我自己的测试,css modules只转换class和id,此外的标签选择符、伪类等都不会被转换。
建议只使用class。
一个css module的输出
简单用console.log()就可以查看css module的输出:
var styles = require("./main.css"); console.log("styles = ", styles);
结果类似这样:
{ "btn-sp": "_2scq7kuv31niiivu-q2uba _2r6ezfeknjgc7gly11yrmv", title: "_1m-kkpqynpiso3ofwhmvuk" }
这可以帮助理解css modules是怎样工作的。
预编译器
sass等预编译器也可以用css modules,对应的loader可能是这样:
{ test: /\.scss$/, loader: 'style!css?modules!resolve-url!sass?sourcemap' }
注意不要因为是sass就习惯性地用嵌套写法,css modules并不适合使用包含选择符。
建议的命名方式
css modules会把.title转换为styles.title,由于后者是用在javascript中,因此驼峰命名会更适合。
如果像我之前那样写.btn-sp,需要注意在javascript中写为styles["btn-sp"]。
此外,你还可以为css-loader增加camelcase参数来实现自动转换:
{ test: /\.css$/, loader: 'style!css?modules&camelcase', }
这样即便你写.btn-sp,你也可以直接在javascript里用styles.btnsp。
结语
无论是一直以来我们认真遵循的命名约定,还是这个新的css modules,目的都是一样的:可维护的css代码。我觉得就css modules基本还是在写css这一点来说,它还是很友好的。
虽然本文为了严谨,结果写了相当长的篇幅,但希望你读过之后,还能觉得css modules是简单易懂的。因为这样,我就达成我的目的:扣题,了。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。