萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> Div CSS 教學

團隊協作 CSS 書寫規範:命名、架構、效能與維護

代碼風格

  • **單行寫法** 便於 Diff,構建時壓縮:`.mod { color: #333; padding: 10px; }`
  • **縮進 2 空格**,冒號後一空格,分號結尾,左大括號前一空格。
  • **編碼統一 UTF-8**,存檔無 BOM。

架構與分工

base.css       /* Reset、變數、通用工具類、Header/Footer 共用 */
module-x.css   /* 業務模組獨立樣式,由對應前端負責 */
page-y.css     /* 頁面級微調,極少 */

協作流程:架構師輸出 `base.css` + 頁面框架 HTML (含 ID 鉤子) → 前端實現模組內部結構與樣式 → 禁止隨意修改 `base.css`,衝突提交 Issue 協商。

ID 與 Class 命名規範

規則說明範例
ID唯一、父級佈局容器、JS 鉤子預留#header, #main-nav, #js-modal
Class可複用、子級組件、修飾狀態.btn, .btn-primary, .is-active
命名組成小寫字母 + 數字 + 連字符.comment-list, .item-3, .icon-user
語義化表達「是什麼」而非「長什麼樣」.error-msg ❌ .form-error ✅
避免拼音國際化、可讀性.hongse ❌ .red ✅

命名衝突規避策略

  1. **從屬選擇器**:`.mod-a .title {}` — 耦合 HTML 結構,修改結構需改 CSS。
  2. **父級前綴**:`.mod-a-title {}` — 類 BEM Block,結構解耦,推薦。
  3. **個人前綴**:高復用工具類 `.u-clearfix`、`.j-show` (JS 鉤子 `js_` 前綴)。

效能與相容性原則

  • **Sprite 合圖**:按模組合圖,減少 HTTP 請求,`background-position` 定位。
  • **PNG 8 優先**,半透明需 IE6 時 `_filter: AlphaImageLoader`。
  • **禁用 CSS3 實驗屬性** (text-shadow, gradient 等) 除非項目明確現代瀏覽器のみ。
  • **減少 `position:absolute` / `float`** — 觸發重排、層級管理難,優先 Flex/Grid。
  • **屬性書寫順序**:佈局定位 → 盒模型 → 文字樣式 → 視覺裝飾 → 其他。

註釋規範

/* ===== Module: Comment List ===== */
/* --- List Container --- */
.comment-list { ... }
/* --- List Item --- */
.comment-item { ... }
/* ===== /Module: Comment List ===== */

大模組頂部必寫區塊註釋,小模組適量行內註釋。

copyright © 萬盛學電腦網 all rights reserved