萬盛學電腦網

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

CSS 專案架構組織術:ITCSS 分層、註釋規範與可維護檔案結構實戰

為什麼需要組織架構

隨著專案增長,單一巨型 CSS 檔案導致:尋找困難、衝突頻發、重構恐懼、新人上手陡峭。良好架構 = 可預測的檔案位置 + 可控的層疊順序 + 清晰的依賴關係。

ITCSS(Inverted Triangle CSS)七層架構

由 Harry Roberts 提出,按通用性→具體性、低優先級→高優先級、隱式→顯式倒三角分層:

  1. Settings:全域變數、設計令牌(色彩、間距、字體、斷點、z-index 層級)
    _settings.colors.scss、_settings.spacing.scss
  2. Tools:全域 Mixin、Function、Placeholder(不輸出 CSS)
    _tools.mixins.scss、_tools.functions.scss
  3. Generic:重置、Normalize、Box-sizing 全域化、HTML 基礎樣式
    _generic.reset.scss、_generic.normalize.scss
  4. Elements:裸標籤樣式(h1、p、a、ul、table、form 元素)
    _elements.headings.scss、_elements.forms.scss
  5. Objects:非裝飾性、可復用設計模式(佈局、容器、媒體物件、旗幟物件)
    _objects.container.scss、_objects.grid.scss、_objects.media.scss
  6. Components:具體 UI 元件(按鈕、卡片、模態框、導航、表單控件)
    _components.buttons.scss、_components.modal.scss
  7. Utilities:高優先級、單一職責工具類(.u-mt-4、.u-hidden、.u-text-center),允許 !important
    _utilities.spacing.scss、_utilities.display.scss

主入口檔案引入順序(關鍵)

@use 'settings/*' as *;
@use 'tools/*' as *;
@use 'generic/*' as *;
@use 'elements/*' as *;
@use 'objects/*' as *;
@use 'components/*' as *;
@use 'utilities/*' as *;

嚴禁跨層 @forward 或 @use 逆向依賴,防止循環引用與層疊失控。

註釋規範:讓代碼會說話

/* ==========================================================================
   Component: Button — 可互動按鈕元件
   ========================================================================== */
/* Base: 預設樣式 ........................................................ */
.btn { ... }
/* Variant: 主要/次要/危險 ................................................. */
.btn--primary { ... }
.btn--danger { ... }
/* State: hover/focus/disabled/loading ................................... */
.btn:disabled { ... }
/* Layout: 尺寸變體 ...................................................... */
.btn--sm { ... }
.btn--lg { ... }
  • 區塊標題用 === 分隔,子區段用 ... 對齊
  • 關鍵決策加 /* [Note] reason */、Hack 加 /* [Hack] browser bug */

避坑指南

  • ❌ 按頁面/路由拆檔 → 元件散落、重複率高
  • ❌ 所有東西塞進 components/ → Objects/Utilities 混淆
  • ✅ 嚴守分層職責,新增代碼先問「屬於哪一層?」
  • ✅ 定期審視 Settings/Tools 是否膨脹,拆分細粒度檔案
copyright © 萬盛學電腦網 all rights reserved