| 維度 | ID (#id) | Class (.class) |
|---|---|---|
| 唯一性 | 頁面內**唯一** | 可**多次復用** |
| 優先級權重 | 0,1,0,0 (100) | 0,0,1,0 (10) |
| JS 掛鉤 | document.getElementById、#id 選擇器 | querySelectorAll、getElementsByClassName |
| 錨點鏈接 | <a href="#section"> 直接跳轉 | 不可作錨點 |
| 表單關聯 | <label for="id">、<input form="id"> | 無 |
| CSS 架構角色 | 頁面級唯一容器、JS 鉤子 | 組件/模塊/工具類復用單元 |
.btn-primary、#main-header.error-message ≻ .red-text.nav 可,.n 不可。.1col ❌ → .col-1 ✅.block { } /* 獨立塊 */
.block__element { } /* 依附於塊的元素 */
.block--modifier { } /* 狀態/變體 */
/* 實例:卡片組件 */
.card { }
.card__image { }
.card__title { }
.card__content { }
.card--featured { } /* 特色變體 */
.card--compact { } /* 緊湊變體 */
.card__image--rounded { } /* 元素級修飾 */
/* HTML */
<article class="card card--featured">
<img class="card__image card__image--rounded" src="...">
<h2 class="card__title">標題</h2>
<div class="card__content">內容</div>
</article>
優勢: 扁平選擇器(權重統一 0,0,1,0)、無嵌套耦合、自文檔化、團隊溝通零歧義。
/* 尺寸變體 */
.btn--sm { padding: .25rem .5rem; font-size: .875rem; }
.btn--lg { padding: .75rem 1.5rem; font-size: 1.25rem; }
/* 狀態變體 */
.btn--disabled { opacity: .6; pointer-events: none; }
.btn--loading { position: relative; color: transparent; }
.btn--loading::after { content: ""; /* spinner */ }
/* 主題變體 */
.btn--primary { background: var(--color-primary); }
.btn--secondary { background: var(--color-secondary); }
.btn--ghost { background: transparent; border-color: currentColor; }
// .stylelintrc.json
{
"rules": {
"selector-class-pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*(__[a-z0-9]+(-[a-z0-9]+)*)?(--[a-z0-9]+(-[a-z0-9]+)*)?$",
"selector-id-pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$",
"selector-max-id": 0, // 禁止 CSS 中使用 ID 選擇器
"selector-max-compound-selectors": 3,
"custom-property-pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
}
}
// Button.stories.tsx
import { Meta, StoryObj } from '@storybook/react';
import { Button } from './Button';
const meta: Meta = {
title: 'Components/Button',
component: Button,
argTypes: {
variant: { control: 'select', options: ['primary', 'secondary', 'ghost'] },
size: { control: 'select', options: ['sm', 'md', 'lg'] },
},
};
export default meta;
| 反模式 | 問題 | 重構 |
|---|---|---|
#header .nav li a | 高優先級、結構耦合、不可復用 | .nav__link |
.red-button | 表現耦合,換膚需改 HTML | .btn--danger |
.col-1, .col-2 ... .col-12 | 網格類污染全局命名空間 | CSS Grid / Utility-first (Tailwind) |
| 同一元素多 ID | 無效 HTML、JS 選擇錯誤 | 改用 Class 組合 |
| CSS 中大量 ID 選擇器 | 優先級戰爭、無法覆蓋 | 僅作 JS 鉤子/錨點,樣式用 Class |
/* 設計 Token 統一管理 */
:root {
--color-primary: #0066cc;
--space-4: 1rem;
--radius-md: 0.5rem;
}
/* 組件內部消費 Token */
.btn { padding: var(--space-2) var(--space-4); border-radius: var(--radius-md); }
/* Tailwind 風格原子類(如採用) */
<button class="bg-blue-600 text-white px-4 py-2 rounded-md hover:bg-blue-700">
ID 歸 JavaScript/錨點/表單,Class 歸 CSS/復用/組合。BEM 給團隊統一語言,Stylelint 給規範長牙齒,Token 給設計系統靈魂。