只要用得得法,為 CSS 檔加上註解,能在開發過程中幫你和團隊省下大量時間。最常見的用法是替樣式規則補充說明,但註解的價值遠不止於此——它在組織結構與提升效率上同樣有用。
這是註解最主流的用途。留下清楚的提示,可以避免後期接手時不必要的困惑與來回確認。這種應用最講究簡潔,例如:
/* Turn off borders for linked images */
img { border: 0; }
許多設計與開發人員會在更新後的 CSS 檔頂端標註日期時間與自己的名字,這些資訊提供了聯絡窗口與文件版本線索:
/* Styles Updated: Thu 4.8.08 @ 5:15 p.m. Author: MB5U.com --------*/
團隊協作時,這種做法尤其重要。不過要提醒的是,有些組織明確要求在文件中保留這類資訊,也有些公司偏好把名字與日期放在文件之外管理,所以動手之前最好先確認慣例。
用註解標示不同區塊,是保持樣式表可讀性的好習慣。舉例來說,若所有頁首相關的樣式集中在同一處,就可以用註解把它和後續區塊清楚隔開:
/* HEADER -------------------------------------*/
接著我們談談如何「分離樣式類型」。
如果你的 CSS 檔已依區塊劃分,那麼搭配註解標記與編輯器的「搜尋」功能,就能在文件各段之間快速跳轉。做法是先用等號「=」標示章節,後面接上區塊名稱,例如「HEADER」,等於替你的樣式表建立了一個錨點:
/* =HEADER -------------------------------------*/
在內容龐雜的樣式表中,這個技巧的效果特別明顯——找樣式不再靠翻滾條一路滑到底。