設計標記(Design Tokens)
一組經過命名的少量數值,並在所有地方一致使用,是讓網站看起來經過設計而非拼湊而成的關鍵。在定義元件之前先定義標記;稍後若要更改品牌,只需編輯一個區塊即可。
需要詢問的內容
一個品牌色(或一個情緒字詞)、淺色或深色底色,以及整體調性(企業、俏皮、編輯、技術)。其餘所有內容都可以推導出來。
顏色
以角色而非顏色名稱來工作,這樣重新命名品牌時就不需要重新命名。
| 標記 | 角色 | 經驗法則 |
|---|---|---|
--bg | 頁面背景 | 米白色或接近黑色,永遠不要使用純 #fff 或 #000 |
--surface | 卡片、輸入框 | 亮度與 --bg 相差 2 到 4% |
--text | 內文文字 | 在 --bg 上至少要有 7:1 的對比度 |
--muted | 次要文字 | 在 --bg 上至少要有 4.5:1 的對比度 |
--border | 極細線條 | 將文字顏色的 10 到 15% 混合到背景顏色中 |
--accent | 按鈕、強調 | 品牌色 |
--accent-ink | 在 --bg 上的連結和強調文字 | 將品牌色調暗(或在深色背景上調亮)直到通過 4.5:1 的對比度 |
--on-accent | 在強調色上的文字 | 白色或深色中,何者能通過 4.5:1 的對比度 |
指導原則:
- 將中性色稍微向強調色的色調方向偏移(2 到 6% 的飽和度)。純灰色放在溫暖的強調色旁邊會顯得不協調。
- 大約在 10% 的表面積上使用強調色。如果每樣東西都被強調,那就等於沒有強調。
- 很少需要第二個強調色。只有為了表示不同的意義(例如成功或特價)時,才添加一個。
- 對於深色模式,不要做反轉處理。隨著層級提高,提高表面的亮度,並稍微降低強調色的飽和度,使其不會發光。
如果 webcraft CLI 可用,請用它來產生一組起始標記,而不是手動推導數值。它會應用上述所有規則,調整亮度直到每一對都通過對比度檢查,並分別建立深色主題:
webcraft tokens "#e4572e" --tone editorial -o tokens.css # 也可以使用:--base dark, --radius pill
webcraft tokens "#e4572e" --format theme-json # 使用相同數值的 WordPress theme.json
在 MCP 用戶端內部,同樣的功能是 generate_tokens 工具。將輸出視為初稿:用肉眼調整,然後重新檢查。
在最終確定之前,檢查每一對文字和背景:
webcraft contrast "#1b1b1f" "#f6f4ef"
webcraft contrast --tokens tokens.css
python scripts/contrast.py --tokens tokens.css # 無需安裝的備用方案,僅限十六進位值
第一種形式會印出一對組合的對比度和 WCAG 等級。第二種形式會讀取一個 CSS 檔案,並檢查每個主題區塊(:root、[data-theme]、prefers-color-scheme)中的標準角色配對,會解析 var() 並讀取 hex、rgb()、hsl()、oklch() 和 color-mix()。失敗的配對是新網站上最常見的無障礙缺陷,而且對於視力良好且在良好螢幕上觀看的人來說是看不見的,這就是為什麼這是一個腳本而不是人為判斷的原因。
字體排印
- 最多兩個字體家族:一個用於標題,一個用於內文。通常,一個字體家族使用兩種粗細會更好。
- 透過結構對比來配對(襯線展示字體搭配無襯線內文字體,或壓縮展示字體搭配一般內文字體),而不是兩個相似的无襯線字體。
- 內文字體大小 16 到 18px,行高 1.5 到 1.7,行長度 60 到 75 個字元。
- 展示字體:行高 0.95 到 1.1,字距追蹤隨尺寸增大而變為負值。
- 使用帶有
clamp()的流體級距,這樣在不同斷點之間就不會有跳躍感:
:root {
--step--1: clamp(0.83rem, 0.8rem + 0.15vw, 0.9rem);
--step-0: clamp(1rem, 0.95rem + 0.25vw, 1.125rem);
--step-1: clamp(1.25rem, 1.1rem + 0.6vw, 1.6rem);
--step-2: clamp(1.6rem, 1.3rem + 1.3vw, 2.4rem);
--step-3: clamp(2rem, 1.5rem + 2.6vw, 3.6rem);
--step-4: clamp(2.5rem, 1.6rem + 4.6vw, 5.5rem);
--step-5: clamp(3rem, 1.5rem + 7vw, 7.5rem);
}
- 使用
font-display: swap載入字體,預先載入在折疊線上使用的一或兩個檔案,如果是自行託管,則需進行子集化。
間距、圓角、陰影
:root {
--space-1: 0.25rem; --space-2: 0.5rem; --space-3: 0.75rem; --space-4: 1rem;
--space-6: 1.5rem; --space-8: 2rem; --space-12: 3rem; --space-16: 4rem;
--section: clamp(4rem, 3rem + 6vw, 9rem); /* 區塊之間的垂直內距 */
--gutter: clamp(1rem, 0.5rem + 3vw, 3rem); /* 頁面側邊內距 */
--container: 76rem;
--radius-sm: 8px; --radius: 16px; --radius-lg: 28px; --radius-pill: 999px;
--shadow: 0 1px 2px rgb(0 0 0 / .04), 0 8px 24px rgb(0 0 0 / .06);
}
- 選擇一種轉角個性(銳利、柔和或膠囊狀)並保持一致。混合使用多種圓角是看起來不一致的最快途徑。
- 區塊之間的間距應明顯大於區塊內部的間距;這種差距是告訴眼睛一個區塊在哪裡結束的關鍵。
輸出
交付一個 tokens.css,其中包含 :root 區塊、一個可選的 [data-theme="dark"] 區塊,以及一個簡短的表格說明每個標記在何處使用。然後說明內文文字、次要文字和按鈕文字的對比度結果。
重新命名現有網站
首先將現有的硬編碼值對應到角色(搜尋 CSS 中的十六進位色碼並計算出現次數),用標記取代它們,確認視覺上沒有任何改變,然後再交換標記的值。同時進行這兩個步驟會讓回歸問題變得無法追蹤。