萬盛學電腦網

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

CSS 模組化架構與命名規範:BEM、SUIT、前綴策略的層級分離編程實戰

為什麼需要 CSS 架構與命名規範?

  • 大型專案樣式衝突頻發
  • 團隊協作維護成本高
  • 重構風險大,不敢刪除舊代碼
  • 缺乏統一標準導致風格混亂

三大主流命名規範深度比較

1. BEM (Block Element Modifier) — 最廣泛採用

/* 語法 */
.block { }
.block__element { }
.block--modifier { }

實例:商品卡片元件

.product-card { }                    /* 區塊 */
.product-card__image { }               /* 元素 */
.product-card__title { }               /* 元素 */
.product-card__price { }               /* 元素 */
.product-card__price--sale { }         /* 修飾詞:特價 */
.product-card__price--original { }     /* 修飾詞:原價 */
.product-card--featured { }            /* 區塊修飾詞:精選 */
.product-card--compact { }             /* 區塊修飾詞:緊湊版 */

BEM 優缺點

優點缺點
極低耦合,類名獨立類名較長
語意清晰,關係一目了然修飾詞易濫用(如 --large, --red)
無需巢狀,優先級平坦需團隊共識嚴格執行
利於 JS 狀態切換

2. SUIT CSS — BEM 變體,駝峰式命名

/* 語法 */
.u-utility { }              /* 工具類 */
.ComponentName { }          /* 元件 */
.ComponentName--modifierName { }  /* 修飾詞 */
.ComponentName-descendantName { } /* 後代元素 */
.ComponentName.is-stateName { }   /* 狀態類 */

實例

.ProductDetails { }
.ProductDetails-price { }
.ProductDetails-title--sale { }
.ProductDetails.is-loading { }

關鍵差異

  • 元件名駝峰式 ProductDetails(而非 product-details)
  • 後代元素用單連字號 -descendant(而非 __element)
  • 狀態類用 is- 前綴
  • 工具類用 u- 前綴

3. 簡易前綴策略 — 輕量級專案首選

.s-   /* 結構/佈局:structure */
.t-   /* 主題/外觀:theme */
.js-  /* JavaScript 掛載:行為鉤子,不定義樣式 */
.u-   /* 工具類:utility */
.is-  /* 狀態類:state */
.has- /* 狀態類:擁有某狀態 */

實例

.s-container { }
.s-grid { }
.t-primary { }
.t-dark-mode { }
.js-modal-trigger { }
.u-text-center { }
.is-active { }
.has-error { }

層級分離架構:ITCSS (Inverted Triangle CSS)

按特異性與影響範圍分層,由低到高:

1. Settings      - 變數、配置(色彩、間距、斷點)
2. Tools         - 函式、Mixin
3. Generic       - 重置、Normalize、box-sizing
4. Elements      - 裸標籤樣式(h1, a, table)
5. Objects       - 設計模式/佈局骨架(.o-container, .o-grid)
6. Components    - 具體 UI 元件(.c-button, .c-card)
7. Utilities     - 高優先級工具類(.u-hidden, .u-mt-4)

專案落地檢查清單

  • ☐ 選定命名規範(BEM/SUIT/前綴)並寫入貢獻指南
  • ☐ 建立 .stylelintrc 強制命名格式
  • ☐ 依 ITCSS 分層組織資料夾結構
  • ☐ 定義 Design Tokens(色彩、間距、字體、陰影、圓角、轉場)
  • ☐ 建立共用元件庫(Storybook / Styleguidist)
  • ☐ 制定 CSS 變數命名規範(--color-primary-500)
  • ☐ 定期執行「未使用 CSS」掃描清理

避坑指南

  • ❌ 修飾詞濫用:.btn--large-red-rounded-shadow → ✅ 拆解為組合類
  • ❌ 混用多種規範 → ✅ 專案統一單一規範
  • ❌ 樣式穿透元件邊界 → ✅ 使用 CSS Modules / Shadow DOM / Scoped CSS
  • ❌ 全域汙染裸標籤 → ✅ 僅在 Generic 層設定基礎排版
copyright © 萬盛學電腦網 all rights reserved