盡量寫 .nav {} 而非 ul.nav {}。過度限定會降低效能、減弱 class 復用性、提高選擇器權重,這些都是應盡力避免的。
利用註釋掉的類型選擇器,標示 class 預期作用的元素:
/*html*/.product-page {}
/*ol*/.breadcrumb {}
/*p*/.intro {}
/*ul*/.image-thumbs {}
這樣開發者一眼就能知道 .product-page 應用於 <html>,.breadcrumb 用於 <ol>,卻不增加實際權重。
在樣式區塊上方加入可搜尋的標籤(以 ^ 開頭):
/**
* ^navigation ^lists
*/
.nav {}
/**
* ^grids ^lists ^tables
*/
.matrix {}
搜尋 ^lists 即可同時定位到 .nav、.matrix 等所有列表相關樣式,極大提升大型專案的維護效率。
當基礎樣式與擴充樣式分散在不同檔案(如 base.css 與 theme.css),用註釋建立雙向連結:
/* base.css */
.foo {}
/**
* Extend `.foo` in theme.css
*/
/* theme.css */
.bar {}
/**
* Extends `.foo` in base.css
*/
這讓開發者在跳轉檔案時仍能掌握樣式繼承關係,避免遺漏覆寫。
善用 CSS 註釋不只是「寫給自己看」,更是團隊協作的溝通橋樑。準修飾、標籤化、繼承標記三大技巧,能讓樣式表自文件化、可搜尋、可追蹤,是專業前端工程師的必備素養。