命名是工程化的基石。混亂的命名導致樣式衝突、難以復用、團隊協作成本激增。本文提出基於「模塊前綴 | 類型 | 作用」的結構化命名規範,配合常用縮寫表,構建可擴展、低認知負荷的 CSS 架構。
.news-list ✅ / .red-box ❌(顏色變更時名稱失真).module-type-name,不使用駝峰、下劃線、大寫.header-、.nav-、.btn-、.form-,防止全局污染-primary、-secondary、-disabled、-loading、-lg/-sm[模塊前綴]-[類型]-[作用]__[元素]--[狀態|變體]
/* 例子 */
.header__logo /* Header 模塊的 Logo 元素 */
.nav__item--active /* Nav 模塊的 Item 元素,Active 狀態 */
.btn--primary--lg /* Btn 組件,Primary 變體,Large 尺寸 */
.card__title--truncated /* Card 組件 Title 元素,截斷狀態 */
採用 BEM (Block Element Modifier) 變體:雙下劃線 __ 連接元素,雙連字符 -- 連接修飾符,清晰可讀、工具友好。
| 語義 | 縮寫 | 適用場景 |
|---|---|---|
| Container / Wrapper | ct / wrap | 外層容器 |
| Header / Footer | hd / ft | 頁頭/頁腳 |
| Navigation / Menu | nav / menu | 導航/菜單 |
| Sidebar / Aside | side / asd | 側邊欄 |
| Main / Content | main / cnt | 主內容區 |
| Module / Block / Component | mod / blk / comp | 功能塊 |
| List / Item | lst / itm | 列表/項 |
| Button | btn | 按鈕 |
| Input / Textarea | ipt / ta | 輸入框 |
| Label / Title / Caption | lbl / tt / cap | 標籤/標題 |
| Image / Icon / Avatar | img / icn / avt | 圖片/圖標/頭像 |
| Link / Anchor | lnk | 鏈接 |
| Form / Field / Group | fm / fld / grp | 表單/字段/分組 |
| Table / Row / Cell | tbl / row / cell | 表格/行/單元格 |
| Pagination / Page | pg / page | 分頁 |
| Modal / Dialog / Popup | mod / dlg / pop | 彈層 |
| Tooltip / Tips / Hint | tip / hint | 提示 |
| Alert / Notice / Msg | alt / ntc / msg | 警告/通知/消息 |
| Header / Body / Footer (組件內) | hd / bd / ft | 組件內部結構 |
| Primary / Secondary / Danger / Success | pri / sec / dan / suc | 語義色變體 |
| Large / Medium / Small / Mini | lg / md / sm / xs | 尺寸變體 |
| Active / Current / Selected | act / cur / sel | 激活態 |
| Hover / Focus / Disabled | hov / fcs / dis | 交互態 |
| Hidden / Visible / Show / Hide | hdn / vis / show / hide | 顯隱態 |
| Loading / Error / Empty | ldg / err / emp | 數據態 |
.btn /* 基礎按鈕 */
.btn--pri /* 主要按鈕 */
.btn--sec /* 次要按鈕 */
.btn--dan /* 危險按鈕 */
.btn--lg / .btn--sm /* 尺寸變體 */
.btn--block /* 塊級按鈕 */
.btn--disabled / .btn[disabled] /* 禁用態 */
.form__grp /* 字段分組 */
.form__lbl /* 標籤 */
.form__ipt /* 輸入框 */
.form__ipt--err /* 錯誤態輸入框 */
.form__msg /* 提示信息 */
.form__msg--err /* 錯誤提示 */
.nav /* 導航容器 */
.nav__lst /* 列表 */
.nav__itm /* 項 */
.nav__lnk /* 鏈接 */
.nav__itm--act /* 當前項 */
.nav__lnk--hov /* 懸停態(如需單獨樣式) */
.card
.card__hd / .card__bd / .card__ft
.card__img
.card__ttl
.card__desc
.card__act
.card--bordered / .card--shadow / .card--hoverable
css/
├── base/
│ ├── reset.css /* Normalize + 基礎重置 */
│ ├── variables.css /* CSS Custom Properties: 色彩、間距、字體、斷點、z-index */
│ └── typography.css /* 全局排版:標題、段落、鏈接、列表 */
├── layout/
│ ├── grid.css /* 頁面級網格:container、row、col */
│ ├── header.css
│ ├── footer.css
│ └── sidebar.css
├── components/
│ ├── btn.css
│ ├── form.css
│ ├── nav.css
│ ├── card.css
│ ├── modal.css
│ └── ...
├── utilities/
│ ├── spacing.css /* m-/p- 工具類 */
│ ├── display.css /* d-none/d-flex/d-grid */
│ ├── text.css /* ta-c/ta-l/fw-b/fs-sm */
│ └── visibility.css /* v-h/v-v/overflow-h */
├── pages/
│ ├── home.css
│ ├── list.css
│ └── detail.css
└── themes/ /* 多主題/品牌定制 */
├── dark.css
└── brand-a.css
好的命名是給未來的自己和隊友寫的文檔。遵循「語義化、模塊化、標準化」,配合現代工程化工具鏈,讓 CSS 從「寫時只懂自己,過後天曉得」進化為「人人可讀、處處可復用、版本可追溯」的資產。