寫 CSS 時,類別與 id 的名稱完全由自己決定——這點和重新定義標籤的選擇器不同,後者必須與預設標籤名完全吻合。正因為自由,隨手亂取就成了一種常見的坏习惯。
替一個 div 命名時,最自然的念頭是描述它在頁面上的位置,於是會出現這類名稱:
.top-panel .horizontal-nav .left-side .center-column .right-col
這些都是合法有效的命名,簡單、顧名思義,確實達到了標示頁面元素與對應樣式的目的。
問題在於它們綁死在「某種特定的視覺呈現」上。名稱參照的是某個版面配置中的位置,一旦換了版型,這些名字就不合適,甚至造成誤導——名為 .left-side 的區塊被搬到右邊時,後接手的人只會一頭霧水。更根本的問題是,它們完全沒有反映文件的內容結構。
Andy Clarke 與 Eric Meyer 曾分別分析大量倡導標準化設計的網站原始碼。雖然命名五花八門,仍看得出幾個高頻出現的名字:
header content nav sidebar footer
完整清單可參考他們整理的常見命名慣例表。
這些名字是否代表某種標準已經誕生?就我而言,我樂見其成,但當時還不到那個階段。真正理想的狀態,是對那些天天出現的通用頁面元件有一套共通命名;這不只讓人讀得懂,更能大幅降低交接與維護成本——尤其是在不同時期、不同人開發的網站之間來回工作時。
歸納起來,命名時可以問自己三個問題:
第一,它描述的是「內容」還是「位置」?優先用內容取名字。側邊那塊放的是導覽就叫 nav,放的是相關連結就叫 related;哪天版面把它移到頁尾,名稱依然成立。
第二,它描述的是「用途」還是「樣子」?.highlight 比 .yellow-text 好,因為重點在「這段需要被強調」,而不是「它是黃色的」;換個配色方案時,前者不用改。
第三,名字能不能自成一套?用 BEM 這類命名法把區塊、元素、修飾符的關係寫進名稱(例如 .card__title--featured),可以讓大型專案裡的樣式不致互相污染,也讓搜尋整個專案時更容易定位。
最後,別忘了連字符(site-nav)與底線(site_nav)擇一貫用就好,html 與 body 之外避免用大寫,並且在整個專案裡保持一致。命名這件事看似瑣碎,卻是少數「今天多花一分鐘、明天少花一小時」的投資。