李涛自留地
回到顶部
首页 > 前端 > css命名规则有哪些?BEM与原子化的6条落地约定

css命名规则有哪些?BEM与原子化的6条落地约定

文章目录

两个列表页摆在一起:A 页四十多个类名按 BEM 拼,改主色要动六个文件;B 页 class 平均十来个词,改主色只改一个变量。都干净,接手成本差一截。真正难的从来不是风格,css命名规则要定的是几件事的归属:谁负责定位、状态挂在哪一层、哪条线不许越过去。名字稳了,改一次才知道会牵动谁。

一个名字里装了几件事

一套规则要管的就三件:组件内部的层级怎么标、状态怎么标、可复用的单属性怎么标。BEM 管前两件,块、元素、修饰三段式正好给层级和变体各留一个位置;原子化管第三件,把间距、颜色、字号拆成单独的类。

顶部一个方块向下分出元素、修饰、状态三支

两边不是替代关系,是同一条链的两端。项目里只要同时存在两种组件,交接处的规矩就得自己补。

收成六条:块的定位权、状态的位置、原子的边界、层级的上限、改名的验证、新名字的归属。每条都能落到一个动作上,落到「看着整齐」的不算。

落到实际:新项目从 BEM 起步,组件过三十个、设计稿又改得勤,再引原子层;两个都上,界线在第一天就得划清,否则第三种写法一定会长出来。

BEM 里谁负责定位、谁负责长相

块管外部:在页面里占哪块位置、上下留多少距离、跟隔壁块怎么排。元素管内部:字号、行高、padding、子元素之间的间距。修饰只动一个维度,宽窄、主题、方向。

违反这条最常见的样子,是给元素写 margin-top。列表项里的标题加 12px 上边距,第一项就多出一截,只能再补一条 :first-child 归零。改成块统一给 padding、元素不碰外边距,对齐问题自己消失。

落点就两行:外边距归块,排版归元素,两件事不写在同一个选择器里。这两行也是css命名规则里最省解释成本的一条,一句话就能跟新人讲完。

/* 块负责与外部的关系,元素只处理自己内部 */
.card {
  margin-bottom: 16px;   /* 块与块之间的距离归块 */
}
.card__title {
  font-size: 14px;
  line-height: 1.4;      /* 元素只管内部排版 */
}

把 .card 的 margin-bottom 从 16 改成 24,卡片之间统一变宽,卡片内部一个字没动。改动能不能只落在一条规则上,就是这条约定值不值钱的检验。

权重上更直接。改之前是 .user-card .user-card-header .user-card-header-title,三个类名,权重 0,3,0;改完是 .user-card__title,0,1,0。要让某个标题变色,原来得把那串写满再加 --urgent,现在一个修饰就够。这条从权重算下来最清楚,也是最常被跳过的一半——模板里 grep 得到,JS 里拼字符串的那 4 处 querySelector 一样得跟着改。

状态词该挂在哪一层

状态只挂块根。展开、选中、禁用、加载中,四个都在说整个组件处在什么阶段,元素只是跟着变样。

挂在元素上会出两件事:同名的 is-active 在三个元素上含义不同,grep 出来分不清;父级状态一变,得逐个元素加类,漏一个就半开半合。

<!-- 状态挂在块根,子元素靠后代选择器跟着变 -->
<div class="panel is-open">
  <div class="panel__body">内容</div>
  <div class="panel__foot">操作</div>
</div>

这段结构里 is-open 只有一个。样式写成 .panel.is-open .panel__body,权重 0,2,0,不需要 !important。

id 别进选择器。有个后台外层套了 #app,写成 #app .panel .panel__body,权重 1,2,0,比带状态那条高出一整个 id,怎么加类都改不动那行 display。把 id 从选择器里删掉,问题当场没了。

原子化的边界画在哪

进原子层的只有三类:间距、颜色、字号(含行高和字重)。这三样在设计稿里改得最勤,又最没有语义。一条样式落哪一层,先在这三项上做一次决策,别边写边定。

三项判断汇到一个决策点,再分出两条路

组件内部的排布不进原子层。卡片里标题和图标的相对位置,写 display: flex; gap: 8px 就留在块里,别拆成 flex 加 gap 两个词挂到 HTML 上。

界线画错的样子很有辨识度:原子类开始表达结构,.flex .items-center .justify-between 拼出一个工具栏,读的人得在脑子里把几个词翻译回一个布局。换个人接手,改一处要试三遍。

判断顺序可以固定:这条样式改的是间距、颜色还是字号?是,进原子层,统一前缀;不是,问它属于哪个块;块内元素之间,写给元素;块与块之间,写给块根。这段界线争议最大,因为设计稿每次改版都会往原子层多推一点。

后代选择器最多叠几层

两层,> 只用一层。

左右两栏各压一个数字,底部横条贯穿

这一条最好验证:数一下选择器里有几个空格,就知道超没超。超过两层基本可以断定块没切对。一个块要三层后代才定位得到,说明中间那层没有自己的名字。

改之前是三层后代,改完是单类名。权重一边 0,3,0,另一边 0,1,0,影响面也跟着缩:前者动一次得顺着祖先链想一遍,后者只落在一个块上。

翻旧样式表数过:三层以上的后代选择器二十多条,大半指向同一个卡片块。改法是把中间层提成元素名,.card .card-header .card-header-title 收成 .card__title,.card-header 只在它自己有 padding 或边框时保留。改完再数,三层选择器剩 4 条,全是面板里的表格。

老实说,这个上限是从维护成本倒推的:三层选择器出问题时,得同时看三个文件才知道谁覆盖了谁。

改完名字怎么证明没漏

模板里的类名可以 grep,JS 里拼出来的 grep 不到。看产物更直接。

// 数产物里还剩多少个以 card 开头的类名
const fs = require('fs');
const css = fs.readFileSync('dist/app.min.css', 'utf8');
const all = css.match(/\.[a-zA-Z][\w-]*/g) || [];
const left = new Set(all.filter(n => n.startsWith('.card')));
console.log(left.size, [...left].join(' '));

跑完输出一个数字加一串类名。改之前 12 个,改完剩 8 个。这 4 个差额还得拿同一套正则去扫构建后的 JS,扫到了才是模板字符串里拼的,扫不到就是漏在别的样式表里。数字比翻文件可靠,也是整条规则里唯一能自动核对的一环。

新名字归谁定

css命名规则最后落到人身上:谁新增块,谁定块名。新增块的人定块名,元素名跟着块走。跨块复用一律不许——两个块长得像,就把共同部分提成第三个块,别让第二个块去用第一个块的元素名。

评审只看一条:这个名字拿掉上下文还认不认得出来。.list__item 离开 .list 就不知道是什么,.order-row 单独出现也说得清。前者省字,后者省沟通。

两个页面重来一次

B 页那 11 个词的 class 更像标准答案,它省下的是改主色的时间,付出的是每次加功能都要重读一遍布局。A 页反过来,改主色最贵,读结构最便宜。两边都没错,错在把其中一个当成了通用答案。

重来一次,第一步会把块切出来,元素名关在块内部,原子层只留间距、颜色、字号。这六条里我先定的会是块的边界,css命名规则剩下的部分都从它推出来。

代价是前期多花两三个小时画块,收益落在第三个人接手的那天。

若非作者标注皆为李涛自留地原创文章,转载或复制请以超链接形式并注明出处。