命名大概是樣式表裡最耗心力的環節,尤其當頁面上有一堆長相相似、用途相近的模塊時。下面這套約定仍在實踐中,但方向是明確的:讓名稱能被讀懂、能被排序、能長期不失效。
第一,名稱不要綁定具體視覺狀態。像顏色、字號這類資訊一旦寫進類名,設計一改就名不符實。用 .notice-red 稱呼一個紅色提示框,哪天改成橙色,類名就變成謊言了;改用 .notice-warning 才站得住腳。
第二,遵守字元與大小寫約束。類名建議由以字母開頭的小寫字母(a-z)、數字(0-9)、下劃線(_)與減號(-)組成;ID 名稱則由不以數字開頭的小寫字母、數字、下劃線組成。
可以採用這樣的規則:
[模塊前綴|類型|作用]_[名稱]_[狀態|位置]
也就是先約定模塊、類型、狀態、位置各自使用哪些單詞或縮寫,保持順序一致,並盡量用兩到三個單詞把用途說清楚。順序固定下來的好處是,同類的類名會在代碼編輯器的補全列表中自動聚在一起。
| 含義 | 縮寫 | 含義 | 縮寫 |
|---|---|---|---|
| 設置 | set | 成功 | suc |
| 提示 | hint | 操作 | op |
| 密碼 | pw | 菜單 | menu |
| 按鈕 | bt | 文本 | tx |
| 顏色 | c | 背景 | bg |
| 邊框 | bor | 居中 | center |
| 圖標 | icon | 彈出 | pop |
.input_tx /* 文本輸入框 */ .input_pw_login /* 登錄密碼輸入框 */ .hint_suc_blogset /* 日誌設置成功提示 */ .pop_set_photo /* 相冊彈出的設置層 */ .hint_bg /* 公共提示背景 */ .c_tx /* 文本顏色 */ .c_tx_p /* 段落文本顏色 */
從上往下看,可以清楚讀出「類型 + 對象 + 場景」的層次,這正是結構化命名想達到的效果。
約定的價值來自一致,而不是來自縮寫本身有多聰明。團隊內先把詞表定下來並寫進規範文檔,比各自發揮重要得多。若專案規模較大,可以進一步引入 BEM 這類有明確 Block、Element、Modifier 層次的方案,讓命名規則與 CSS 選擇器的嵌套深度互相配合。