base.css /* Reset、變數、通用工具類、Header/Footer 共用 */
module-x.css /* 業務模組獨立樣式,由對應前端負責 */
page-y.css /* 頁面級微調,極少 */
協作流程:架構師輸出 `base.css` + 頁面框架 HTML (含 ID 鉤子) → 前端實現模組內部結構與樣式 → 禁止隨意修改 `base.css`,衝突提交 Issue 協商。
| 規則 | 說明 | 範例 |
|---|---|---|
| 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 ✅ |
/* ===== Module: Comment List ===== */
/* --- List Container --- */
.comment-list { ... }
/* --- List Item --- */
.comment-item { ... }
/* ===== /Module: Comment List ===== */
大模組頂部必寫區塊註釋,小模組適量行內註釋。