我們通常應該避免过度修飾選擇器——能寫 .nav {} 就不要寫 ul.nav {}。過度修飾會拖累效能、降低 class 的複用性,並不必要地提高選擇器的專屬程度。
但有時候你確實想告訴同事「這個 class 打算用在哪種元素上」。以 .product-page 為例,它看起來像是一個根容器,可能是 html 或 body,但光看名字無從確認。
解法是把類型選擇器註釋掉,形成「準修飾」寫法:
/*html*/.product-page {}
這樣既傳達了預期的作用範圍,又不影響複用性。其他例子:
/*ol*/.breadcrumb { }
/*p*/.intro { }
/*ul*/.image-thumbs { }
寫完一組新樣式時,可以在上方加上標籤註釋:
/**
* ^navigation ^lists
*/
.nav { }
/**
* ^grids ^lists ^tables
*/
.matrix { }
這些標籤讓其他開發者能快速定位相關程式碼。需要找所有與列表有關的部分時,只要搜尋 ^lists,就能一次跳到 .nav、.matrix 以及其他標了同樣標籤的地方。
這在大型程式碼庫中尤其有用,因為它建立了一套橫跨檔案的分類索引,不必依賴檔案結構就能找到功能相近的樣式。
用物件導向的思路寫 CSS 時,你常會遇到兩段密切相關(一為基礎、一為擴展)卻分散在不同檔案中的樣式。繼承標記就是在兩者之間建立明確關聯。
在基礎樣式中註明:
/**
* Extend `.foo` in theme.css
*/
.foo { }
在擴展樣式中註明:
/**
* Extends `.foo` in base.css
*/
.bar { }
如此一來,即使兩段程式碼相隔千里,維護者也能循線找到彼此,不至于改了基礎樣式卻漏掉所有衍生版本。
這三個技巧的共同點是:它們都不影響瀏覽器解析,成本幾乎為零,卻能顯著降低團隊協作的溝通成本。註釋寫得好,某種程度上就是給未來的自己寫的一份說明書。