萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> Div CSS 教學

CSS 命名規範完全指南:語義化、BEM、ITCSS 與團隊協作標準化體系

命名基礎規則

  • 字符集:小寫字母、數字、連字符 -、下劃線 _,**必須字母開頭**,不可純數字。
  • 編碼:UTF-8,文件頭聲明 @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

進階架構:BEM + ITCSS 分層

BEM(Block Element Modifier)

.card { }                    /* Block */
.card__image { }             /* Element */
.card__title { }             /* Element */
.card--featured { }          /* Modifier */
.card__image--rounded { }    /* Element Modifier */

優勢:關係清晰、優先級扁平(全 0-0-1-0)、零嵌套依賴。

ITCSS(Inverted Triangle CSS)分層

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 { }

工程化落地清單

  1. 制定《CSS 命名規範文檔》,納入項目 Wiki,新人必讀。
  2. Stylelint 規則:selector-class-pattern 強制 BEM/前綴格式。
  3. 設計系統輸出 Figma Token → Style Dictionary 生成 CSS 變量 + 命名映射表。
  4. Code Review 檢查點:語義化、無視覺描述、層級前綴正確、BEM 結構完整。
  5. 定期審查:廢棄類名清理、同義詞合併、命名字典更新。

總結

優秀的 CSS 命名是**領域語言**,而非視覺備忘錄。語義化 + BEM 結構 + ITCSS 分層 + 團隊字典 + 自動化檢查,構建出可讀、可搜、可維護、可擴展的樣式命名體系,是前端工程化成熟度的核心指標之一。

copyright © 萬盛學電腦網 all rights reserved