萬盛學電腦網

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

CSS 樣式命名規範:語意化、可維護的實務指南

CSS 命名規範:從亂無章法到結構化管理

隨專案規模增長,混亂的命名會讓維護陷入地獄。本文提供一套實戰驗證的命名規範,涵蓋字元規則、結構化公式、常用縮寫與實例。

一、核心原則

  1. 避免外觀描述: 命名反映功能/結構(.btn-submit),而非樣式(.red-button),樣式變更時命名仍具意義。
  2. 字元規則: class 以小寫字母開頭,可含小寫字母、數字、底線、連字號;id 不得以數字開頭,建議同樣採小寫+連字號。

二、結構化命名公式

[模組前綴|類型|功能]_[名稱]_[狀態|位置]

  • 模組前綴:專案/模組代號(如 mkt、usr)
  • 類型:layout、module、component、utility 等
  • 功能:nav、form、list、card、btn、input 等
  • 名稱:具體描述(如 login、search)
  • 狀態/位置:active、disabled、top、bottom、hover 等

單詞數控制在 2-3 個,保持簡潔。

三、常用單詞縮寫表

全寫縮寫
settingset
successsuc
hint/tiphint
operationop
passwordpw
menumenu
buttonbtn
texttxt
colorc
backgroundbg
borderbor
centerctr
iconico
popuppop

四、實際命名範例

  • 文字輸入框:.input-txt
  • 密碼輸入框:.input-pw
  • 登入密碼輸入框:.input-pw-login
  • 部落格設定成功提示:.hint-suc-blogset
  • 相簿彈出設定層:.pop-set-photo
  • 公共提示背景:.hint-bg
  • 文字顏色:.c-txt
  • 段落文字顏色:.c-txt-p

五、團隊落地建議

  • 建立專案命名規範文件,納入 Code Review 檢查項目。
  • 配合 BEM、SMACSS 或 ITCSS 等架構方法論,進一步規範模組劃分與命名層級。
  • 定期重構舊命名,避免技術債累積。

嚴謹的命名規範是 CSS 架構長期健康的基石,值得從專案伊始就投入建立。

copyright © 萬盛學電腦網 all rights reserved