CSS 命名是代碼可讀性、可維護性、團隊協作效率的基石。糟糕的命名(如 .aaabb、.red、.leftBar)會導致樣式與結構強耦合、重構災難、溝通成本激增。本文建立基於語義化、功能導向、結構解耦的命名體系,涵蓋 BEM、ITCSS、工具類等主流方法論精華,提供可直接落地的規範手冊。
.btn-primary ✅ vs .blue-btn ❌ .top-button ❌結合 BEM(Block Element Modifier)的組件封裝能力與 ITCSS(Inverted Triangle CSS)的層級管理,構建三層命名體系:
/* 變量命名:前綴 -- + 域 + 屬性 + 變體 */
--color-brand-primary: #0066cc;
--color-brand-primary-hover: #0052a3;
--spacing-unit: 8px;
--font-size-base: 1rem;
--border-radius-base: 4px;
--transition-fast: 150ms ease;
類名不直接出現在此層,僅供上層引用。
/* Block: 獨立功能塊 */
.card { }
.card--featured { } /* Modifier: 變體 */
.card--compact { }
/* Element: 區塊內部組成部分,雙下劃線連接 */
.card__header { }
.card__title { }
.card__body { }
.card__footer { }
.card__action { }
/* Element Modifier: 元素變體 */
.card__title--large { }
.card__action--primary { }
/* State: 狀態類(JavaScript 動態切換),is-/has- 前綴 */
.card.is-loading { }
.card.is-expanded { }
.card.has-error { }
/* 佈局工具 */
.flex { display: flex; }
.flex-center { display: flex; align-items: center; justify-content: center; }
.grid-2 { display: grid; grid-template-columns: repeat(2, 1fr); gap: var(--spacing-lg); }
/* 間距工具(Tailwind 風格) */
.m-0 { margin: 0; }
.mt-1 { margin-top: calc(var(--spacing-unit) * 1); }
.mx-auto { margin-left: auto; margin-right: auto; }
.p-2 { padding: calc(var(--spacing-unit) * 2); }
/* 顯示/隱藏 */
.d-none { display: none; }
.d-block { display: block; }
.d-flex { display: flex; }
/* 文本工具 */
.text-center { text-align: center; }
.text-primary { color: var(--color-brand-primary); }
.fw-bold { font-weight: 700; }
.truncate { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
| 語義域 | 標準詞彙 | 禁用詞彙 |
|---|---|---|
| 容器 | container, wrapper, box, inner | outer, main-div, content-box |
| 導航 | nav, menu, tabs, breadcrumb, pagination | navbar, top-bar, link-list |
| 表單 | form, field, input, label, control, group, hint, error | txt-box, btn-submit, form-item |
| 反饋 | alert, toast, modal, dialog, tooltip, popover, spinner, skeleton | msg-box, tip, loading-icon |
| 媒體 | img, video, audio, avatar, thumbnail, gallery, carousel | pic, photo, banner-img |
| 狀態 | active, disabled, loading, error, success, warning, empty | on, off, ok, bad, hide |
/* 反例 */
.red-text { color: red; }
.big-title { font-size: 24px; }
.left-sidebar { float: left; width: 200px; }
.border-bottom-gray { border-bottom: 1px solid #eee; }
重構:
/* 語義化 */
.text-error { color: var(--color-error); }
.heading-xl { font-size: var(--font-size-xl); }
.sidebar { /* 佈局由父容器控制 */ }
.divider { border-bottom: 1px solid var(--color-divider); }
/* 反例 */
.header-nav-ul-li-a { color: #333; }
.article-content-p-span { font-size: 14px; }
重構:
/* 解耦:組件內部使用 Element */
.nav { }
.nav__list { }
.nav__item { }
.nav__link { color: var(--color-text); }
.article { }
.article__body { }
.article__text { font-size: var(--font-size-base); }
/* 反例 */
.cnt { } /* container? content? count? */
.img-wrp { } /* image-wrapper? */
.btn-prim { } /* primary? */
原則: 寧長勿短,完整單詞優於模糊縮寫。通用縮寫(btn, nav, hdr, ftr, cnt)需寫入團隊詞彙表。
// .stylelintrc.json 關鍵規則
{
"rules": {
"selector-class-pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*(__[a-z0-9]+(-[a-z0-9]+)*)?(--[a-z0-9]+(-[a-z0-9]+)*)?$", // BEM 正則
"selector-max-id": 0, // 禁止 ID 選擇器
"selector-max-compound-selectors": 3, // 限制複合選擇器深度
"custom-property-pattern": "^--[a-z]+-[a-z0-9]+(-[a-z0-9]+)*$" // 變量命名
}
}
優秀的 CSS 命名體系具備三大特質:
建立項目級《CSS 命名規範手冊》,接入 Stylelint 強制執行,讓命名成為團隊的共同語言,而非個人的風格表達。