/* 完整規則集 */
selector { /* 選擇器:鎖定目標元素 */
property: value; /* 聲明:屬性 + 值 */
property2: value2; /* 多聲明用分號分隔 */
}
/* 實例 */
article h2 {
color: #1a1a2e; /* 顏色值:十六進制 */
font-size: 1.5rem; /* 尺寸值:相對單位 rem */
margin-bottom: 0.5em; /* 間距值:相對字體大小 em */
border-bottom: 2px solid currentColor; /* 邊框簡寫:寬度 樣式 顏色 */
}
body { font-family: system-ui, sans-serif; } /* 標籤名 */
p { line-height: 1.6; }
.card { } /* 通用類 */
.card--featured { } /* BEM 修飾符 */
.card__title { } /* BEM 元素 */
.is-hidden { display: none; } /* 狀態類,JS 切換 */
命名規範:小寫字母+數字+連字符(kebab-case),語義化(.btn-primary 而非 .blue-button)。
#app { } /* 頁面根容器 */
#main-content { } /* 主內容區,供跳轉錨點 / JS 掛載 */
⚠️ 樣式盡量不用 ID,優先級過高難覆蓋,留給 JS document.getElementById、<a href="#id"> 錨點、ARIA aria-labelledby。
h1, h2, h3, h4, h5, h6 {
font-weight: 600;
line-height: 1.3;
color: var(--color-text-heading, #111);
}
.btn, .link-button, input[type="submit"] {
/* 統一按鈕基礎樣式 */
}
.nav a { } /* 後代:.nav 內所有 a */
.nav > li { } /* 子代:.nav 直接 li 子元素 */
.nav + .sidebar { } /* 相鄰兄弟:緊跟 .nav 後的 .sidebar */
.nav ~ .footer { } /* 通用兄弟:.nav 後所有 .footer */
margin: 1rem 2rem 1.5rem 0.5rem; /* 上 右 下左 */
padding: 1rem 2rem; /* 上下 左右 */
border: 1px solid #ddd; /* 寬度 樣式 顏色 */
background: #f5f5f5 url("bg.png") center / cover no-repeat border-box border-box;
/* 色值 圖片 位置/尺寸 重複 起源 裁切 */
:root {
/* 設計令牌 */
--color-brand-50: #e6f0ff;
--color-brand-500: #0066ff;
--color-brand-600: #0052cc;
--space-1: 0.25rem; --space-2: 0.5rem; --space-4: 1rem; --space-8: 2rem;
--radius-sm: 4px; --radius-md: 8px; --radius-lg: 12px; --radius-full: 9999px;
--shadow-md: 0 4px 6px -1px rgba(0,0,0,.1), 0 2px 4px -2px rgba(0,0,0,.1);
--font-sans: system-ui, -apple-system, "Segoe UI", Roboto, "Noto Sans TC", sans-serif;
}
.card {
padding: var(--space-4);
border-radius: var(--radius-lg);
box-shadow: var(--shadow-md);
font-family: var(--font-sans);
}
/* 主題切換:僅覆蓋根變量 */
[data-theme="dark"] {
--color-brand-50: #1e3a5f;
--color-brand-500: #60a5fa;
--color-brand-600: #93c5fd;
}
.modern-colors {
/* RGB + Alpha */
color: rgb(255 0 0 / 0.8); /* 空格分隔,斜杠透明度 */
/* HSL + Alpha */
background: hsl(210 100% 50% / 0.1);
/* Lab/LCH:感知均勻色彩空間 */
border-color: lch(50% 100 295);
/* color() 函數:指定色彩空間 */
fill: color(display-p3 1 0 0); /* 廣色域紅 */
}
styles/
├── settings/ # 設計 Token、變量、配置
│ ├── _tokens.css
│ ├── _breakpoints.css
│ └── _animations.css
├── tools/ # Mixin、Function(預處理器)或通用工具類
│ └── _helpers.css
├── generic/ # Normalize/Reset、全局基礎
│ ├── _reset.css
│ └── _normalize.css
├── elements/ # 裸標籤樣式(極少)
│ ├── _typography.css
│ └── _forms.css
├── objects/ # 佈局骨架、無業務語義
│ ├── _container.css
│ ├── _grid.css
│ └── _media.css
├── components/ # 業務組件(BEM 命名)
│ ├── _button.css
│ ├── _card.css
│ ├── _modal.css
│ └── _form-field.css
├── utilities/ # 高優先級工具類(單一職責)
│ ├── _spacing.css
│ ├── _display.css
│ └── _text.css
└── main.css # 入口文件,按順序 @import
<link> vs 構建工具@import 解析為單文件,無額外請求。<link rel="stylesheet" href="main.css">,按依賴順序手動合併壓縮。color、font-*、line-height 可繼承;margin、padding、border、width、background 不繼承。box-sizing: border-box 讓 width 包含 padding+border,符合直覺。「CSS 易學難精:語法是門檻,架構是分水嶺。從『寫出效果』進化到『寫出可維護、可擴展、可主題化的系統』,是前端工程師成長的必經之路。」