CSS 註解(也常被寫成「註釋」)是在程式碼中插入說明文字的做法,就像在文章上劃重點寫眉批一樣。它的內容不會被瀏覽器解析,也不會出現在畫面上。
/* 註解內容 */
以「/*」開始、「*/」結束,說明文字寫在中間。
<style type="text/css">
.box { width: 100px; } /* 寬度為 100px */
</style>
@charset "utf-8";
/* 樣式表版本與作者資訊 */
.box { width: 100px; } /* 寬度為 100px */
兩處的語法完全相同,差別只在檔案位置。
1、自我說明:標註某段樣式對應頁面的哪個區塊、負責什麼功能,三個月後回頭看還能秒懂。
2、團隊協作:多人維護同一份樣式表時,註解是最基本的溝通介面。
3、暫時停用:把整段樣式包進註解裡,可以快速測試而不必刪除程式碼。
4、條件式註解:歷史上曾用來針對特定 IE 版本餵送樣式,如今多已被特性偵測取代。
/* 全域設定 */
body { text-align: center; margin: 0 auto; }
/* 頁首 */
#header { width: 960px; height: 120px; }
「/*」與「*/」必須是半角英文符號,用中文輸入法打出的全形符號會導致語法錯誤。另外星號與文字之間建議留一個空格,可讀性更好。CSS 註解不支援巢狀,包錯一層可能讓後面大段樣式一起失效。
原則上該寫就寫,但也不必逐行註解——註解過多會增加檔案體積,正式上線前可透過壓縮工具移除。