萬盛學電腦網

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

CSS 命名規範系統化指南:模塊前綴、語義單詞、縮寫表與 BEM 實踐

命名是 CSS 維護性的核心。建立系統化命名規範:避免狀態耦合、統一詞彙表、採用模塊前綴、推行 BEM 結構化命名。

核心原則

  1. 語義而非表現:用 .error-msg 而非 .red-text;顏色變更時名稱仍有效
  2. 字符集限制:
    • Class:小寫字母、數字、下劃線 _、連字符 -,字母開頭
    • ID:同上,但不可數字開頭
  3. 結構化模式:[模塊前綴|類型|動作]_[名稱]_[狀態|位置]

通用詞彙縮寫表(團隊統一)

全拼縮寫全拼縮寫
設定set成功suc
提示hint操作op
密碼pw菜單menu / nav
按鈕btn文本txt / tx
顏色c / clr背景bg
邊框bor / bd居中ctr / mid
圖標ico / icon彈出pop / dlg
輸入框input / ipt容器wrap / ct

實戰命名示例

語義Class 命名說明
文本輸入框.input_txt類型_名稱
密碼輸入框.input_pw
登錄密碼輸入框.input_pw_login模塊_類型_名稱
日志設置成功提示.hint_suc_blogset動作_狀態_模塊
相冊彈出設置層.pop_set_photo類型_動作_模塊
公共提示背景.hint_bg
文本顏色.c_txt屬性_對象
段落文本顏色.c_txt_p屬性_對象_限定

BEM 規範對比

/* 傳統 */ .search_input_login { }
/* BEM   */ .search__input--login { }
.block__element--modifier
優勢:結構清晰、關係明確、工具友好(Stylelint、IDE 跳轉)

工程化落地

  • Stylelint 配置 selector-class-pattern 強制命名規則
  • IDE Snippets 內置常用模塊前綴
  • 設計系統輸出 Design Tokens → CSS 變量 → 語義化 Class 自動生成
  • Code Review 清單納入命名檢查項

避坑指南

  • 禁用 .left、.big、.red 等表現類名
  • 禁用過長名稱(>30 字符)或過短(<3 字符無語義)
  • 同一模塊內類名保持前綴一致
  • JS 掛鉤專用前綴 .js-,樣式類嚴禁供 JS 選取
copyright © 萬盛學電腦網 all rights reserved