UI 設計:建立介面的規則
這些規則濃縮自 Michael Filipiuk 的《UI 設計原則》(2021 年版)。此檔案包含適用於每個畫面的規則。references/ 資料夾(位於此檔案旁)則存放各主題的詳細內容,每個主題一個檔案;僅讀取你的任務會觸及到的檔案。
無標籤的規則皆來自該書。(WCAG) 標記該書未提及的無障礙標準。(convention) 標記為填補缺口而加入的常見業界慣例值。(derived) 標記使用該書自有方法計算出的值。書中的 1 pt 等於 1 CSS px 等於 1 iOS pt 等於 1 Android dp。
專案倉庫的設計系統優先
如果專案倉庫已有 tokens 或主題(如 Tailwind 設定、CSS 變數、shadcn/MUI 主題、components/ui/ 函式庫),請使用它們。此技能僅用來補充它們未定義的部分。
- 切勿在專案倉庫的 tokens 旁引入第二組 tokens。
- 重複使用現有元件,而不是建立一個並行的元件。
- 當專案倉庫本身違反了以下任一規則(例如對比度不足、按鈕高度為 32 px),請保留專案倉庫的值,並回報此衝突。請勿靜默地覆蓋它。
規則衝突時的優先順序: 可用性 > 無障礙 > 一致性 > 簡潔性 > 美觀。
快速路徑
- 先確定個性: 基於品牌和受眾,選擇活潑、中性或嚴肅 (
references/personality-and-copy.md)。切勿根據個人品味。 - 畫面之前先有 tokens: 從專案倉庫或
references/tokens.md取得色彩、字體級數和間距級數。禁止使用這些範圍之外的值。 - 灰階優先: 先確保層級、佈局和間距正確,然後只在有必要的地方加入色彩。
- 元件需具備所有狀態(預設、懸停、按下、焦點、禁用、錯誤、成功),且每個畫面需具備所有狀態(空、載入中、錯誤、404)。
- 在報告完成之前: 針對你所建置的內容,檢查
references/checklist.md。如果可以截圖,請檢查截圖,而不是檢查程式碼。
不容妥協的原則
- 間距必須來自級數。 行動裝置使用 4 pt 級數,網頁使用 8 pt 級數。禁止使用 5、13 或 22 px 的值。
- 內文文字大小為 16–17 px。 任何文字都不得低於 10 px,建議使用 12 px 或更大。切勿對小號文字使用 Light 字重。
- 使用一種字體, 預設為無襯線字體。約使用 5 種大小。
- 文字或陰影切勿使用
#000000。 請使用深色帶灰調的顏色,例如#1F1F1F。 - 使用一種主要色彩, 僅應用於必須突出的元素。如果所有東西都突出,那就等於什麼都沒突出。
- 對比度: 內文文字需達到 4.5:1,大號文字和 UI 元件需達到 3:1 (WCAG)。
- 切勿僅使用色彩來傳達意義。 錯誤訊息、成功訊息和連結也需搭配圖示、文字、字重或底線。
- 每個點擊或觸碰目標至少為 44×44, 即使可見的圖示較小。
- 按鈕高度為 40–60 px, 每組僅一個主要按鈕。當按鈕成對出現時,主要按鈕在右側。按鈕標籤需精確說明將發生的動作。
- 輸入框務必有可見的標籤。 僅有預留文字不算標籤。使用單欄式表單搭配內嵌驗證,且絕不應清除使用者已輸入的內容。
- 陰影應柔和(較大的 Y 軸偏移、較大的模糊值、5–10% 不透明度),且僅用於互動式或浮起的元素。
- 圖示來自同一套件, 風格一致,具有相同的筆畫寬度和圓角。不為人熟知的圖示需附上標籤。
- 動畫用於提供反饋, 持續時間低於 1000 毫秒,並使用緩動函數(絕不應是線性)。
- 不要使用 Lorem Ipsum。 撰寫真實、簡短、人性化的文案。錯誤訊息應說明如何解決問題。對話框應指明物件及其後果。
- 相同事物,相同外觀,相同行為,需在不同畫面間保持一致。遵循平台模式來決定行為。
該讀取哪個參考檔案
| 任務觸及到 | 請讀取 |
|---|---|
| 新專案或新主題,選擇數值 | tokens.md(間距、字體級數、色彩角色、圓角、陰影、動畫、入門 CSS) |
| 頁面或畫面佈局、網格、間距、層級 | layout.md |
| 文字樣式、標題、段落 | typography.md |
| 調色盤、深色模式、陰影、漸層 | color-and-depth.md |
| 按鈕和行動呼籲按鈕 | buttons.md |
| 表單、輸入框、下拉選單、核取方塊、驗證 | forms.md |
| 卡片、項目列表 | cards.md |
| 圖示 | icons.md |
| 分頁列、頂部導覽、側邊欄、連結 | navigation.md |
| 照片、插圖、空狀態和 404 藝術 | imagery.md |
| 品牌感受、按鈕標籤、對話框、錯誤訊息、語氣 | personality-and-copy.md |
| 轉場、懸停、載入、反饋 | motion.md |
| 對比度、替代文字、目標大小、說明文字 | accessibility.md |
| 要重複使用的元件、狀態、空/404 畫面、設計系統 | system-and-states.md |
| 審查完成的畫面 | checklist.md |
所有路徑均位於此技能的 references/ 資料夾下。