好的代碼規範,是團隊協作與長期維護的基石。以下從語法、命名到組織,整理一套完整的 HTML 與 CSS 撰寫準則。
無論有多少人參與同一專案,都要確保每一行代碼彷彿出自同一人之手——永遠遵循同一套編碼規範。
建議為 HTML 根元素指定 lang 屬性,有助於語音合成與翻譯工具正確處理內容。同時應明確宣告字元編碼,讓瀏覽器快速判定渲染方式,避免混用字元實體。此外,IE 可透過特定標籤指定相容模式,除非有特殊需求,否則建議設為 edge mode 以採用最新模式。
依 HTML5 規範,引入 CSS 與 JS 時一般不需指定 type 屬性,因為 text/css 與 text/javascript 已是預設值。最重要的是「實用為王」:遵循標準與語義,但別為此犧牲實用性,任何時候都要力求最少的標籤與最小的複雜度。
為確保易讀性,HTML 屬性建議依序排列:class、id/name、data-*、src/for/type/href、title/alt、aria/role。由於 class 用於標示高度可重用的元件,因此應排在首位。
.5 而非 0.5)。#fff)。margin:0)。相關屬性應分組並依序排列:定位(positioning)、盒模型(box model)、排版(typographic)、視覺(visual)。因為定位能將元素移出文檔流並覆蓋盒模型樣式,故排首位;盒模型決定元件尺寸與位置排第二;其餘影響內部的屬性則排在後面。
class 名稱只能用小寫字母與破折號(非底線或駝峰),並以破折號串連相關命名(如 .btn 與 .btn-danger)。名稱應簡短且意義明確,避免任意簡寫與表現式命名。選擇器方面,通用元素優先用 class,避免屬性選擇器,並盡量把選擇器控制在三個元素以內。
以元件為單位組織代碼,採用一致的註釋與空白規範,並依元件(而非頁面)拆分多個 CSS 檔——因為頁面會重組,元件則只是被移動。遵循這套規範,就能寫出靈活、穩定且高品質的代碼。