一個人寫 CSS 可以隨性,一群人同時寫同一個專案就必須有共識,否則樣式互相污染、命名各自表述,最後誰也不敢改。以下這份規範整理自實際的團隊協作經驗,重點在「可預期」與「可分工」。
1. 建議單行書寫,團隊成員可依自身習慣調整,後期統一由工具處理。
2. 依頁面相似度先寫好大體框架文件,再分派給前端人員實作各自的結構、表現與行為。共用的 base.css 由一人統一維護,每頁都必須引入;這份檔案包含 reset 與頁首頁尾樣式,不可任意修改。
3. id 與 class 的分工:id 唯一且屬於父層級,class 可重複且屬於子層級。因此 id 只用在大模塊上,class 用在重複性高或子層級的元素。id 原則上由框架維護者統一命名,唯為 JavaScript 預留的鉤子例外。
4. 編碼統一為 UTF-8。
5. 大框架的名稱(header、footer、wrapper、left、right 等)由框架維護者統一決定。其餘樣式名稱用小寫英文、數字與底線組合,例如 i_comment、fontred、width200。避免使用中文拼音,盡量用簡易單字組合。總的原則是語意化、簡明化。
6. 如何避開命名衝突(這條很重要):
a)用從屬寫法避開;
b)取父層元素 id/class 的一部分來命名;
c)重複使用率高的命名,以自己代號加底線起始,例如 i_clear。
d)a、b 兩條適用於已建好框架的頁面。例如要在 <div id="mainnav"></div> 中加入新元素:
/* a 從屬寫法 */
<div id="mainnav"><div class="firstnav">...</div></div>
樣式:#mainnav .firstnav{.......}
/* b 取父層名稱 */
<div id="mainnav"><div class="main_firstnav">...</div></div>
樣式:.main_firstnav{.......}
7. 為 JavaScript 預留的鉤子請以 js_ 起始,例如 js_hide、js_show。這樣一眼就能分辨哪些 class 是樣式用的、哪些是被程式控制的。
8. 撰寫前先思考並提高樣式的重複使用率。
9. 善用 HTML 自身屬性與樣式繼承來減少程式碼量。例如:
<ul class="list"><li>這兒是標題列表<span>2010-09-15</span></li></ul>
ul.list li{position:relative}
ul.list li span{position:absolute; right:0}
只靠定位就能讓日期靠右顯示,不必為每個 span 額外寫 class。
10. 樣式表中的中文字型名稱務必轉碼為 unicode,以避免編碼出錯時變成亂碼。
11. 背景圖片盡可能使用 sprite 技術以減少 HTTP 請求;考慮到多人協作,sprite 建議按模塊分別製作,避免互相覆蓋。
12. 使用 table 時(盡量避免),不要用 width、height、cellspacing、cellpadding 等屬性直接定義表現,應善用 thead、tr、th、td、tbody、tfoot、colgroup、scope 這些結構性標籤分離結構與表現。cellspacing 與 cellpadding 的 CSS 替代寫法:
table{border:0; margin:0; border-collapse:collapse;}
table th, table td{padding:0;}
13. 不要用 <meta http-equiv="X-UA-Compatible" content="IE=7" /> 來兼容 IE8——這等於強迫新版 IE 用舊引擎渲染,是治標不治本。
14. 使用 png 時要求為 png-8 格式。若 png-8 嚴重影響品質或含有半透明效果,請為 IE6 單獨定義背景:
_background:none; _filter:progid:DXImageTransform.Microsoft.AlphaImageLoader(sizingMethod=crop, src='img/bg.png');
15. 避免使用相容性屬性,例如 text-shadow 或各項 CSS3 屬性(這條寫於 CSS3 尚未普及的年代,如今可依專案目標瀏覽器重新評估)。
16. 減少使用影響效能的屬性,例如 position:absolute 與 float。
17. 大區塊樣式務必加上註解,小區塊適量即可。
18. 屬性撰寫順序建議為:布局定位屬性 → 自身屬性 → 文本屬性 → 其他屬性。這條可依習慣調整,但盡量讓同類屬性寫在一起。各類包含:
布局定位:display、list-style、position(含 top/right/bottom/left)、float、clear、visibility、overflow 自身屬性:width、height、margin、padding、border、background 文本屬性:color、font、text-decoration、text-align、vertical-align、white-space、content
這些只是最常用的部分,並非全部。統一的順序能讓 code review 時的注意力放在真正的差異上,而不是瑣碎的格式。