萬盛學電腦網

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

團隊協作 CSS 規範:從命名規約到架構治理的工程化實踐

背景:為什麼需要 CSS 規範?

CSS 全局命名空間、樣式覆蓋、副作用難追蹤,團隊協作時極易產生「不敢刪、不敢改、不敢動」的脆弱代碼庫。本文提煉企業級 CSS 工程化規範,涵蓋命名、架構、流程、工具鏈。

一、代碼風格與格式化(工具強制統一)

  • 格式化:Prettier + Stylelint(stylelint-config-standard + stylelint-config-rational-order 屬性排序)
  • 單行 vs 多行:單行適合簡單規則,複雜規則多行。由工具統一,不靠人工。
  • 編碼:UTF-8 無 BOM,文件頭 @charset "UTF-8";

二、命名規約:BEM + ITCSS + 設計 Token

1. BEM(Block Element Modifier)核心規則

.block { }                    /* 獨立組件塊 */
.block__element { }           /* 組件內部元素,雙下劃線 */
.block--modifier { }          /* 狀態/變體,雙連字符 */
.block__element--modifier { } /* 元素變體 */

/* 實例 */
.card { }
.card__image { }
.card__title { }
.card--featured { }
.card__image--rounded { }

2. 命名層級與職責分離

層級前綴/命名空間職責示例
設定層無(CSS 變量)設計 Token--color-brand-500, --space-4
通用層u- / util-單一職責工具類u-mt-4, u-d-flex, u-text-center
對象層o-佈局骨架、無業務語義o-container, o-grid, o-media
組件層無前綴(BEM Block)業務組件.card, .btn, .modal
工具/狀態is-, has-JS 切換狀態.is-active, .is-loading, .has-error
JS 鉤子js-僅供 JS 選擇,絕不寫樣式.js-modal-trigger, .js-form-submit
測試鉤子data-testidE2E 測試選擇器data-testid="submit-btn"

3. 衝突規避策略

  • 作用域隔離:CSS Modules / Scoped CSS (Vue/Svelte) / Shadow DOM → 類名哈希化,天然隔離。
  • 命名空間前綴:項目/組件庫級前綴 myapp-、ui-。
  • :where() 零優先級基礎樣式:重置、元素基礎樣式用 :where(),業務樣式輕鬆覆蓋。

三、架構治理:ITCSS 倒三角架構

/* main.css 入口順序:由低優先級、廣泛影響 → 高優先級、局部具體 */
@import 'settings/tokens';      /* 設計 Token,無選擇器 */
@import 'settings/breakpoints'; /* 媒體查詢斷點 */
@import 'tools/helpers';        /* Mixin/Function 或通用工具類 */
@import 'generic/reset';        /* Normalize/Reset */
@import 'generic/normalize';    /* 統一瀏覽器默認 */
@import 'elements/typography';  /* 裸標籤排版 */
@import 'elements/forms';       /* 裸標籤表單 */
@import 'objects/container';    /* 佈局容器 */
@import 'objects/grid';         /* 網格系統 */
@import 'objects/media';        /* 圖文混排對象 */
@import 'components/button';    /* 具體組件 */
@import 'components/card';
@import 'components/modal';
@import 'utilities/spacing';    /* 高優先級工具類 */
@import 'utilities/display';
@import 'utilities/visibility';

四、協作流程與分工

  1. 架構師/Tech Lead:維護 settings/、generic/、objects/,定義 Token、佈局原語、全局重置。
  2. 組件負責人:各自維護 components/xxx.css,遵循 BEM、Token 使用、無障礙、響應式、暗色模式清單。
  3. 頁面開發者:組合組件、使用工具類、嚴禁 在頁面級寫覆蓋組件內部結構的樣式(需通過組件 Props/修飾符/插槽解決)。
  4. Code Review 清單:
    • 是否引入 main.css / 組件樣式?
    • 命名是否符合 BEM/命名空間?
    • 是否使用設計 Token 而非硬編碼值?
    • 是否有 !important、z-index: 9999、魔法數字?
    • 響應式/暗色/無障礙/打印樣式是否覆蓋?

五、關鍵技術規範

1. 字體與圖標

  • 中文字體 font-family 必須轉 Unicode 碼(\5FAE\8F6F\96C5\9ED1)或使用 @font-face 本地加載,避免編碼亂碼。
  • 圖標採用 SVG Symbol / Icon Font / Unicode 字符,統一 .icon 基礎類。

2. 背景圖與 Sprite

  • 多圖標合併為 sprite.svg(<symbol id="icon-xxx">),<use xlink:href="#icon-xxx"> 引用。
  • 大圖/插畫單獨文件,WebP/AVIF + 響應式 srcset。
  • 按模塊/頁面生成 Sprite,避免單一巨大 Sprite 緩存失效波及全站。

3. 兼容性策略

  • 不再支持 IE:移除 _hack、*hack、\9、@media screen\0 等 Hack。
  • 優雅降級:@supports 特性檢測,提供現代寫法 + 兜底。
  • 拒絕 <meta http-equiv="X-UA-Compatible" content="IE=7">:污染渲染模式,阻礙現代特性。

4. PNG/透明圖片處理

  • 優先 png-8 / WebP lossless,體積小、無鋸齒。
  • 必須半透明:png-24 / WebP lossy,IE6 早已棄用,無需 AlphaImageLoader 濾鏡。

5. 性能紅線

  • 禁用 @import 在非構建環境(阻塞渲染)。
  • 慎用 position: absolute/fixed、float 破壞正常流,優先 Flex/Grid。
  • 避免 filter: blur()、box-shadow 大範圍高模糊在滾動容器上(掉幀)。
  • 關鍵 CSS 內聯,非關鍵 media="print" onload="this.media='all'" 異步加載。

6. 註釋規範

/* ===================================
   Component: Card
   Description: 通用卡片容器,支援圖片、標題、操作區
   Dependencies: _tokens.css, _media.css
   =================================== */
.card { }

/* === Section: Layout === */
.card__media { }

/* === Section: States === */
.card--interactive:hover { }

六、自動化保障:CI/CD 管道集成

# package.json scripts
"lint:css": "stylelint \"src/**/*.{css,vue,scss}\" --fix",
"test:css": "npm run lint:css && npm run test:visual-regression",

# Git Hooks (husky)
"pre-commit": "lint-staged"

# lint-staged config
{
  "*.{css,scss,vue}": ["stylelint --fix", "prettier --write"]
}
「CSS 規範的本質是『約束釋放自由』:用極少的強制規則(命名、架構、Token),換取團隊在業務邏輯上的極大自由度與並行開發效率。」
copyright © 萬盛學電腦網 all rights reserved