CSS 無作用域、全域污染、優先序複雜,命名混亂是維護噩夢源頭。建立專業命名規範與架構方法論,是團隊從「能寫出樣式」進化到「寫出可維護、可擴展、高效能樣式系統」的關鍵。本文整合 BEM、ITCSS、OOCSS、SMACSS 精華,構建實戰可落地的完整指南。
| 功能 | 檔名 | 說明 | |
|---|---|---|---|
| 全域重置/基礎 | reset.css / normalize.css | Normalize.css 推薦,保留有用預設 | |
| 全域變數/設計令牌 | tokens.css / variables.css | 色彩、間距、字體、斷點、Z-index | |
| 版面佈局 | layout.css / grid.css | 容器、網格、側邊欄、頁首頁尾 | |
| 字體/排版 | typography.css | 標題、段落、列表、引用、代碼 | |
| 通用元件 | components.css / ui.css | 按鈕、表單、卡片、模態框、標籤 | |
| 模組/業務區塊 | module-{name}.css | 如 module-news.css, module-cart.css | |
| 工具類 | utilities.css / helpers.css | .text-center, .d-flex, .m-4 等單一職能類 | |
| 列印樣式 | print.css | @media print 專用 | |
| 主題/換膚 | theme-{name}.css | 如 theme-dark.css |
| 特性 | ID (#id) | Class (.class) |
|---|---|---|
| 唯一性 | 單頁唯一 | 可多處複用 |
| Specificity | 0,1,0,0 (高) | 0,0,1,0 (中) |
| JS 掛載 | document.getElementById() 最快 | querySelectorAll() |
| 錨點跳轉 | <a href="#section1"> | 不適用 |
| 樣式用途 | 禁止 用於 CSS 選擇器 | 唯一 樣式選擇器來源 |
鐵律:CSS 選擇器絕不使用 ID。ID 留給 JavaScript、ARIA 關聯、頁內錨點。
| 屬性 | 縮寫語法 | 順序/說明 | 範例 |
|---|---|---|---|
| 顏色 | #RGB / #RRGGBB | 每兩位相同可縮寫 | #000, #369, #ff00ff |
| Margin/Padding | m: v1 v2 v3 v4 | 順時針:上右下左。1值=四邊,2值=上下/左右,3值=上/左右/下,4值=上右下左 | margin: 1rem auto; padding: .5rem 1rem 1.5rem; |
| Border | border: width style color | 寬度 風格 顏色 | border: 1px solid #ddd; |
| Background | bg: color image repeat attachment position | 色 圖 平鋪 固定 位置 | background: #f5f5f5 url(bg.png) no-repeat center/cover; |
| Font | font: style variant weight size/line-height family | size/line-height 必填,family 必填 | font: italic bold 1rem/1.5 "Noto Sans TC", sans-serif; |
| List-style | list: type position image | 類型 位置 圖片 | list-style: square inside url(dot.svg); |
width: 100px ✓ / width: 100 ✗(僅 line-height、0 可無單位)#ff0000 ✓ / #FF0000 ✗)、單位(px、em、rem)100px ✓ / 100 px ✗0.5rem ✓ / .5rem ✗color、font-*、line-height 等)在根元素/模組根節點統一宣告,子元素不重複覆寫* { margin: 0; padding: 0; } 過度暴力,建議 Normalize.css 或針對性重置:/*** 針對性重置 ***/
ul, ol, dl, li, dt, dd,
h1, h2, h3, h4, h5, h6,
p, blockquote, figure,
form, fieldset, legend,
table, th, td, caption,
hr, pre, iframe {
margin: 0; padding: 0;
}
img, video, canvas { vertical-align: middle; }
table { border-collapse: collapse; border-spacing: 0; }
/*** 優先序階層(高→低) ***/ /* 1. 行內 style + !important */ /* 2. ID 選擇器 */ /* 3. 類別/屬性/偽類 */ /* 4. 元素/偽元素 */ /* 5. 通用選擇器 * */ /* 6. 繼承 */ /* 7. 瀏覽器預設 */
多重 Class 套用時:樣式表中定義順序較後者勝,非 HTML class 屬性順序。
<div class="a b">內容</div> <div class="b a">內容</div> /* 兩者樣式相同,以 CSS 定義順序為準 */
/*** 後代選擇器:所有層級,代價高 ***/
.nav li { } /* 所有 li,含巢狀子選單 */
/*** 子代選擇器:直接子層,效能佳、語義精確 ***/
.nav > li { } /* 僅第一層 li */
.nav > li > a { } /* 直接連結 */
/*** 建議:模組內部採用子代選擇器,配合 BEM 扁平化 ***/
.nav__item { }
.nav__link { } /* 完全避免後代選擇器 */
/*** 推薦:無引號,相對 CSS 檔案路徑 ***/
background-image: url(../images/bg-pattern.svg);
/*** 避免:引號、絕對路徑 ***/
background-image: url("/assets/images/bg-pattern.svg");
/*** 區塊級元素定寬置中 ***/
.container {
width: 1200px;
max-width: 100%;
margin: 0 auto; /* 左右自動邊距 */
}
/*** Flexbox 置中(現代首選) ***/
.flex-center {
display: flex;
justify-content: center;
align-items: center;
}
/*** Grid 置中 ***/
.grid-center {
display: grid;
place-items: center;
}
/*** 絕對定位置中 ***/
.absolute-center {
position: absolute;
top: 50%; left: 50%;
transform: translate(-50%, -50%);
}
/*** 避免:text-align:center hack (IE5 遺毒) ***/
/* body { text-align: center; } #wrap { text-align: left; margin: 0 auto; } */
現代瀏覽器標準一致性極高,不再需要 Hack。若必須處理舊版 IE:
<!--[if IE 9]><link rel="stylesheet" href="ie9.css"><![endif]-->@supports (display: grid) { ... }.debug { background: rgba(255,0,0,.2); } 可視化盒模型範圍,不影響佈局.debug { outline: 2px solid red; } 不佔空間、不觸發重排,但舊瀏覽器支援度較低/*** 推薦風格:展開、分行、縮進、分號全加 ***/
.selector {
property: value;
another-property: value;
}
/*** 選擇器群組:每個選擇器獨立一行 ***/
.selector-one,
.selector-two,
.selector-three {
property: value;
}
/*** 最後一個屬性也加分號 ***/ /* 防止新增屬性忘記補分號 */
}
工具鏈強制:stylelint + prettier + husky pre-commit hook,統一全團隊風格。
優秀的 CSS 命名規範與架構,能讓陌生開發者在 30 分鐘內理解專案結構、定位問題、安全新增功能。投資於規範建立與工具鏈落地,將在專案生命週期中節省數倍維護成本。從今天開始,為你的 CSS 建立專屬設計系統吧!