修饰符必须绑定到具体 Block 或 Element,不能脱离上下文独立存在;它是组件状态接口,非样式开关,需显式定义样式、语义明确、正交可组合,禁用全局类与组合命名。

修饰符必须绑定到具体 Block 或 Element,不能脱离上下文独立存在
直接结论:用修饰符,不用全局状态类(如 .is-active、.hidden、.loading)。BEM 的修饰符本质是组件接口契约,不是样式开关——它回答的是“这个按钮是不是主操作”,而不是“此刻要不要加背景色”。
常见错误现象:.is-open 被 JS 通配添加到所有弹层容器,结果 .modal__overlay 和 .dropdown__menu 共享同一套动画规则,但语义和过渡时长本应不同;又或者 SSR 渲染时服务端没加 .is-active,客户端 hydrate 后闪动。
-
.modal--open合法:明确归属 modal 块,CSS 可写.modal--open .modal__overlay { animation: fade-in 0.2s; } -
.is-open非 BEM:无块名前缀,无法被 stylelint-bem 校验,工具链不识别,也不保证语义隔离 - 全局类容易被 CSS-in-JS 或 UnoCSS 的 purge 功能误删,尤其在构建时启用 tree-shaking 的项目中
布尔修饰符只能表达“有/无”二元状态,且必须存在即生效
比如 --disabled、--checked、--loading,它们不带值、不表达程度或类型,只回答“是不是”。这和全局 [data-state="loading"] 有本质区别——后者是运行时数据映射,前者是声明式状态投影。
使用场景:表单控件、开关、按钮加载态。关键约束是必须与 DOM 状态同步,例如 input[type="checkbox"] 同时具备 checked 属性和 aria-checked 属性,input--checked 才能安全启用视觉反馈。
- 禁止写
.button--size-large:size 是多态配置,不是非此即彼的状态,应改用键值修饰符--size-large - 禁止写
.switch--on:on/off 是业务逻辑值,和键盘空格切换、SSR 首屏状态不同步,应改用--checked绑定原生行为 - 禁止用
data-属性模拟布尔状态,构建工具可能在压缩阶段移除未引用的data-属性
多个状态要并列使用,不能组合成新修饰符名
BEM 不支持 .button--primary--disabled 这种写法。这不是语法限制,而是语义断裂——它把两个正交状态(主题 + 禁用)强行捏合成一个新概念,导致样式权重失控、调试困难,且无法响应动态状态变更(比如先禁用再切主题)。
正确做法是同时添加多个修饰符:.button--primary.button--disabled。CSS 中分别定义:
.button--primary { background: var(--color-primary); }
.button--disabled { opacity: 0.5; pointer-events: none; }
- 两个修饰符正交,可任意排列、增删,JS 控制更清晰:
el.classList.toggle('button--disabled', isDisabled) - 避免
.button--primary-disabled:一旦未来要支持深色模式下禁用态颜色微调,就得新增--primary-disabled-dark,命名爆炸 - 若发现多个修饰符频繁共存(如
--disabled总跟着--loading),说明状态建模有问题,应回溯业务逻辑是否真需要这两个状态同时存在
键值修饰符必须带语义化值,且值应可枚举、可扩展
当某个特征未来可能增加变体时,必须一步到位设计为键值型。比如圆角,一开始只用 --rounded,后面加 --rounded-full 就破坏了命名体系;尺寸类优先用语义词 --size-small 而非 --small,避免和布尔类混淆层级。
常见错误是把响应式断点塞进修饰符,如 --mobile 或 --sm。断点逻辑该交给 @media 处理,修饰符只表达意图状态(如 --layout-stack)。
-
--theme-dark、--size-large、--radius-sm合法:值为短横线连接的单词,不带单位,可枚举可扩展 -
--radius-4px、--flex-1错误:混入技术单位,失去语义,且无法响应 CSS 变量或设计系统变更 -
--mobile错误:它不是组件意图状态,而是视口条件;应由@media (max-width: 768px)控制.card--layout-stack的表现
修饰符不是“写完就跑”的样式标签,它是组件对外暴露的状态接口。最容易被忽略的一点是:**修饰符必须在 CSS 中显式定义对应样式,否则加了等于没加**——比如写了 .modal--open 却没写任何 animation 或 transition 规则,动画根本不会触发。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











