-、下劃線 _,**必須字母開頭**,不可純數字。@charset "UTF-8";。.user-profile。命名「是什麼」而非「長什麼樣」。視覺描述類名(.red、.big、.float-left)在設計變更時失真,導致「類名與實際樣式不符」的認知負擔。
| ❌ 視覺描述 | ✅ 語義化命名 | 理由 |
|---|---|---|
| .red / .color-red | .text-error / .text-danger | 表達錯誤狀態,而非顏色值 |
| .left-bar / .sidebar-left | .sidebar / .aside | 表達區域功能,位置由佈局決定 |
| .big-title | .heading-primary / .page-title | 表達層級語義,字號由設計系統控制 |
| .clearfix | .clearfix (保留) / .flow-root | 功能性命名可接受,現代用 display:flow-root |
| 類別 | 推薦詞彙 |
|---|---|
| 佈局容器 | container, wrapper, layout, section, region, grid, flex |
| 頁面區塊 | header, footer, main, aside, nav, hero, banner, content |
| 導航相關 | nav, menu, breadcrumb, tabs, pagination, dropdown, sidebar |
| 內容組件 | card, media, article, post, comment, testimonial, avatar, badge |
| 表單元素 | form, field, input, label, select, checkbox, radio, button, submit |
| 狀態修飾 | --active, --disabled, --loading, --error, --success, --warning, --focus |
| 尺寸變體 | --sm, --md, --lg, --xl, --compact, --comfortable, --spacious |
| 工具類 | u-mt, u-mb, u-ml, u-mr, u-p, u-d-flex, u-text-center, u-visually-hidden |
.card { } /* Block */
.card__image { } /* Element */
.card__title { } /* Element */
.card--featured { } /* Modifier */
.card__image--rounded { } /* Element Modifier */
優勢:關係清晰、優先級扁平(全 0-0-1-0)、零嵌套依賴。
1. Settings 設計令牌(變量):colors, spacing, breakpoints
2. Tools 混入、函數:media queries, fluid type
3. Generic 標準化:normalize.css, reset
4. Elements 裸標籤樣式:h1, a, ul, table
5. Objects 非裝飾設計模式:.o-grid, .o-container, .o-layout
6. Components 具體 UI 組件:.c-card, .c-button, .c-modal
7. Utilities 高優先級工具:.u-hidden, .u-clearfix, .u-text-truncate
命名前綴對應層級:s-、t-、g-、e-、o-、c-、u-,優先級遞增,來源順序即優先級順序。
.grid { }
.grid__col { }
.grid__col--1of3 { } /* 三分之一列 */
.grid__col--2of3 { }
.grid__col--3of3 { }
/* 或響應式 */
.grid__col--md-1of2 { }
.grid__col--lg-1of3 { }
selector-class-pattern 強制 BEM/前綴格式。優秀的 CSS 命名是**領域語言**,而非視覺備忘錄。語義化 + BEM 結構 + ITCSS 分層 + 團隊字典 + 自動化檢查,構建出可讀、可搜、可維護、可擴展的樣式命名體系,是前端工程化成熟度的核心指標之一。