核心原則
- 單行聲明:屬性間、屬性名值間、大括號間均保留一空格。
.class { width: 400px; height: 300px; }
- 屬性分組順序(由外至內、整體到細節):
| 組別 | 屬性示例 | 說明 |
| 1. 定位 | position, top, right, bottom, left, z-index, float | 文檔流與定位 |
| 2. 盒模型 | display, margin, padding, width, height, box-sizing | 尺寸與間距 |
| 3. 邊框與背景 | border, border-radius, background, box-shadow | 視覺裝飾 |
| 4. 文字與段落 | font, line-height, text-align, text-indent, color, text-decoration | 內容呈現 |
| 5. 其他 | overflow, cursor, visibility, opacity, transition, transform | 行為與動畫 |
廠商前綴順序
.box {
-webkit-box-shadow: 0 1px 3px rgba(0,0,0,.1);
-moz-box-shadow: 0 1px 3px rgba(0,0,0,.1);
box-shadow: 0 1px 3px rgba(0,0,0,.1); /* 標準屬性最後 */
}
選擇器與命名規範
- 謹慎新增選擇器,優先復用現有樣式,避免濫用 ID 選擇器。
- 全小寫:選擇器、屬性、值(十六進位顏色值除外)。
- 縮寫類名需註釋全稱:
.cl /* Clearfix */
- 避免低效選擇器:
ul li a span → 改用直接類名 .nav-link。
- 慎用 !important:僅用於第三方庫覆寫或極少數工具類。
語義化縮寫前綴規範
| 前綴 | 含義 | 示例 |
| a- | 狀態 active | .a-btn, .a-tab |
| h- / c- / f- | 結構 header/content/footer | .h-wrap, .c-main, .f-links |
| mn- / sd- / nv- / mu- | 區域 main/side/nav/menu | .mn-area, .sd-box, .nv-list, .mu-item |
| l- / tab- / p_ | 樣式 list/tab/popup | .l-post, .tab-nav, .p_pop |
開發流程規範
- 未定事項標記
[!],便於後續討論追蹤。
- 避免 CSS Hack,IE 特殊樣式走條件註釋或獨立補丁檔。
- 定期清理冗餘代碼,配合 Stylelint 自動檢查。
總結
Discuz! X CSS 規範體現了大型社區項目對代碼可維護性、團隊協作效能的嚴格要求。核心思想:統一格式、邏輯分組、語義命名、克制 Hack、持續重構。無論專案大小,建立並執行一套適合團隊的 CSS 規範,都是技術債務控制的關鍵。