實戰開發中,反覆造輪子是極大浪費。建立項目級「CSS 模式庫」,收錄按鈕、表單、文本、佈局、工具類等高頻復用模式,能將樣式開發效率提升 50%+。本文整理生產環境驗證的核心模式代碼,採用 BEM 命名、CSS 變量、現代語法,開箱即用,支援主題定製與無障礙。
:root {
/* 色彩 */
--color-primary: #0066cc;
--color-primary-hover: #0052a3;
--color-primary-active: #003d7a;
--color-success: #28a745;
--color-warning: #ffc107;
--color-error: #dc3545;
--color-text: #212529;
--color-text-muted: #6c757d;
--color-border: #dee2e6;
--color-bg: #fff;
--color-bg-muted: #f8f9fa;
/* 間距 */
--spacing-xs: 4px;
--spacing-sm: 8px;
--spacing-md: 16px;
--spacing-lg: 24px;
--spacing-xl: 32px;
/* 圓角 */
--radius-sm: 4px;
--radius-md: 8px;
--radius-lg: 12px;
--radius-full: 9999px;
/* 陰影 */
--shadow-sm: 0 1px 2px rgba(0,0,0,.05);
--shadow-md: 0 4px 6px rgba(0,0,0,.1);
--shadow-lg: 0 10px 15px rgba(0,0,0,.1);
/* 過渡 */
--transition-fast: 150ms ease;
--transition-base: 250ms ease;
/* 字體 */
--font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
--font-mono: SFMono-Regular, Menlo, Monaco, Consolas, monospace;
--font-size-xs: 0.75rem;
--font-size-sm: 0.875rem;
--font-size-base: 1rem;
--font-size-lg: 1.125rem;
--font-size-xl: 1.25rem;
--font-size-2xl: 1.5rem;
--line-height-tight: 1.25;
--line-height-base: 1.5;
--line-height-relaxed: 1.75;
}
/* 基礎按鈕 */
.btn {
display: inline-flex;
align-items: center;
justify-content: center;
gap: var(--spacing-xs);
padding: var(--spacing-sm) var(--spacing-md);
font-family: var(--font-sans);
font-size: var(--font-size-sm);
font-weight: 500;
line-height: var(--line-height-base);
text-decoration: none;
white-space: nowrap;
border: 1px solid transparent;
border-radius: var(--radius-md);
cursor: pointer;
transition: all var(--transition-fast);
user-select: none;
}
/* 狀態 */
.btn:disabled,
.btn[aria-disabled="true"] {
opacity: 0.5;
cursor: not-allowed;
pointer-events: none;
}
.btn:focus-visible {
outline: 2px solid var(--color-primary);
outline-offset: 2px;
}
/* 變體 */
.btn--primary {
background-color: var(--color-primary);
border-color: var(--color-primary);
color: #fff;
}
.btn--primary:hover:not(:disabled) {
background-color: var(--color-primary-hover);
border-color: var(--color-primary-hover);
}
.btn--primary:active:not(:disabled) {
background-color: var(--color-primary-active);
border-color: var(--color-primary-active);
}
.btn--secondary {
background-color: var(--color-bg-muted);
border-color: var(--color-border);
color: var(--color-text);
}
.btn--secondary:hover:not(:disabled) {
background-color: var(--color-border);
}
.btn--outline {
background-color: transparent;
border-color: var(--color-primary);
color: var(--color-primary);
}
.btn--outline:hover:not(:disabled) {
background-color: var(--color-primary);
color: #fff;
}
.btn--ghost {
background-color: transparent;
border-color: transparent;
color: var(--color-primary);
}
.btn--ghost:hover:not(:disabled) {
background-color: var(--color-bg-muted);
}
/* 尺寸 */
.btn--sm { padding: var(--spacing-xs) var(--spacing-sm); font-size: var(--font-size-xs); }
.btn--lg { padding: var(--spacing-md) var(--spacing-lg); font-size: var(--font-size-base); }
.btn--xl { padding: var(--spacing-lg) var(--spacing-xl); font-size: var(--font-size-lg); }
/* 圖標按鈕 */
.btn--icon-only { padding: var(--spacing-sm); border-radius: var(--radius-full); }
/* 基礎輸入框 */
.form-control {
display: block;
width: 100%;
padding: var(--spacing-sm) var(--spacing-md);
font-family: var(--font-sans);
font-size: var(--font-size-base);
font-weight: 400;
line-height: var(--line-height-base);
color: var(--color-text);
background-color: var(--color-bg);
background-clip: padding-box;
border: 1px solid var(--color-border);
border-radius: var(--radius-md);
transition: border-color var(--transition-fast), box-shadow var(--transition-fast);
appearance: none;
}
.form-control:focus {
border-color: var(--color-primary);
outline: 0;
box-shadow: 0 0 0 3px rgba(0, 102, 204, 0.25);
}
.form-control::placeholder {
color: var(--color-text-muted);
opacity: 1;
}
.form-control:disabled,
.form-control[readonly] {
background-color: var(--color-bg-muted);
opacity: 0.65;
cursor: not-allowed;
}
/* 狀態變體 */
.form-control.is-valid {
border-color: var(--color-success);
background-image: url("data:image/svg+xml,..."); /* 成功圖標 */
background-repeat: no-repeat;
background-position: right var(--spacing-md) center;
padding-right: calc(var(--spacing-md) * 3);
}
.form-control.is-invalid {
border-color: var(--color-error);
background-image: url("data:image/svg+xml,..."); /* 錯誤圖標 */
background-repeat: no-repeat;
background-position: right var(--spacing-md) center;
padding-right: calc(var(--spacing-md) * 3);
}
/* 表單組 */
.form-group { margin-bottom: var(--spacing-md); }
.form-label {
display: block;
margin-bottom: var(--spacing-xs);
font-weight: 500;
color: var(--color-text);
}
.form-text { /* 提示文字 */
margin-top: var(--spacing-xs);
font-size: var(--font-size-sm);
color: var(--color-text-muted);
}
.form-error { /* 錯誤提示 */
margin-top: var(--spacing-xs);
font-size: var(--font-size-sm);
color: var(--color-error);
}
/* 選擇框 */
select.form-control { background-image: url("data:image/svg+xml,..."); /* 自定義下拉箭頭 */ }
/* 多行文本 */
textarea.form-control { min-height: 100px; resize: vertical; }
/* 檢查框/單選框 包裝器 */
.form-check {
display: flex;
align-items: center;
gap: var(--spacing-sm);
min-height: var(--font-size-base);
}
.form-check-input {
width: 1rem;
height: 1rem;
margin-top: 0;
accent-color: var(--color-primary);
}
.form-check-label { cursor: pointer; }
/* 字體族 */
.font-sans { font-family: var(--font-sans); }
.font-mono { font-family: var(--font-mono); }
/* 字號 */
.text-xs { font-size: var(--font-size-xs); }
.text-sm { font-size: var(--font-size-sm); }
.text-base { font-size: var(--font-size-base); }
.text-lg { font-size: var(--font-size-lg); }
.text-xl { font-size: var(--font-size-xl); }
.text-2xl { font-size: var(--font-size-2xl); }
/* 字重 */
.font-normal { font-weight: 400; }
.font-medium { font-weight: 500; }
.font-semibold { font-weight: 600; }
.font-bold { font-weight: 700; }
/* 行高 */
.leading-tight { line-height: var(--line-height-tight); }
.leading-base { line-height: var(--line-height-base); }
.leading-relaxed { line-height: var(--line-height-relaxed); }
/* 顏色 */
.text-primary { color: var(--color-primary); }
.text-muted { color: var(--color-text-muted); }
.text-error { color: var(--color-error); }
.text-success { color: var(--color-success); }
/* 對齊 */
.text-left { text-align: left; }
.text-center { text-align: center; }
.text-right { text-align: right; }
.text-justify { text-align: justify; }
/* 截斷 */
.truncate { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
.line-clamp-2 { display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden; }
.line-clamp-3 { display: -webkit-box; -webkit-line-clamp: 3; -webkit-box-orient: vertical; overflow: hidden; }
/* Flexbox */
.flex { display: flex; }
.inline-flex { display: inline-flex; }
.flex-col { flex-direction: column; }
.flex-wrap { flex-wrap: wrap; }
.items-center { align-items: center; }
.items-start { align-items: flex-start; }
.items-end { align-items: flex-end; }
.justify-center { justify-content: center; }
.justify-between { justify-content: space-between; }
.justify-around { justify-content: space-around; }
.gap-1 { gap: var(--spacing-xs); }
.gap-2 { gap: var(--spacing-sm); }
.gap-4 { gap: var(--spacing-md); }
.gap-6 { gap: var(--spacing-lg); }
.gap-8 { gap: var(--spacing-xl); }
/* Grid */
.grid { display: grid; }
.grid-cols-2 { grid-template-columns: repeat(2, 1fr); }
.grid-cols-3 { grid-template-columns: repeat(3, 1fr); }
.grid-cols-4 { grid-template-columns: repeat(4, 1fr); }
.auto-fit { grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); }
/* 間距 */
.m-0 { margin: 0; }
.m-auto { margin: auto; }
.mt-4 { margin-top: var(--spacing-md); }
.mb-4 { margin-bottom: var(--spacing-md); }
.mx-auto { margin-left: auto; margin-right: auto; }
.p-4 { padding: var(--spacing-md); }
.px-4 { padding-left: var(--spacing-md); padding-right: var(--spacing-md); }
.py-4 { padding-top: var(--spacing-md); padding-bottom: var(--spacing-md); }
/* 尺寸 */
.w-full { width: 100%; }
.h-full { height: 100%; }
.min-h-screen { min-height: 100vh; }
.max-w-screen { max-width: 1200px; }
/* 定位 */
.relative { position: relative; }
.absolute { position: absolute; }
.fixed { position: fixed; }
.sticky { position: sticky; }
.top-0 { top: 0; }
.right-0 { right: 0; }
.bottom-0 { bottom: 0; }
.left-0 { left: 0; }
.z-10 { z-index: 10; }
.z-50 { z-index: 50; }
/* 邊框/圓角/陰影 */
.rounded { border-radius: var(--radius-md); }
.rounded-lg { border-radius: var(--radius-lg); }
.rounded-full { border-radius: var(--radius-full); }
.shadow { box-shadow: var(--shadow-md); }
.shadow-lg { box-shadow: var(--shadow-lg); }
.border { border: 1px solid var(--color-border); }
/* 重置與基線 */
*, *::before, *::after { box-sizing: border-box; }
html {
font-size: 62.5%; /* 1rem = 10px */
-webkit-text-size-adjust: 100%;
scroll-behavior: smooth;
}
body {
margin: 0;
min-height: 100vh;
font: var(--font-size-base)/var(--line-height-base) var(--font-sans);
color: var(--color-text);
background-color: var(--color-bg);
-webkit-font-smoothing: antialiased;
-moz-osx-font-smoothing: grayscale;
}
/* 滾動條美化 (WebKit) */
::-webkit-scrollbar { width: 8px; height: 8px; }
::-webkit-scrollbar-track { background: var(--color-bg-muted); }
::-webkit-scrollbar-thumb { background: var(--color-border); border-radius: var(--radius-full); }
::-webkit-scrollbar-thumb:hover { background: var(--color-text-muted); }
/* 選中文本樣式 */
::selection { background: var(--color-primary); color: #fff; }
/* 圖片響應式 */
img, video { max-width: 100%; height: auto; display: block; }
/* 鏈接基線 */
a { color: var(--color-primary); text-decoration: none; }
a:hover { text-decoration: underline; }
a:focus-visible { outline: 2px solid var(--color-primary); outline-offset: 2px; }
design-tokens.css → reset.css → patterns.css (本文件) → components.css → pages.css<button class="btn btn--primary btn--lg">主要操作</button>:root 變量即可全局切換品牌色、間距體系、字體族這份模式庫涵蓋了 80%+ 業務場景的高頻樣式需求。核心優勢在於:設計令牌驅動(一處修改全局生效)、BEM + 工具類雙軌制(組件封裝與靈活組合並存)、現代語法優先(Flex/Grid/變量/邏輯屬性)、無障礙內建(focus-visible、accent-color、語義屬性)。接入項目,告別重複造輪子,專注業務創新。