讓介面感覺更好的細節
出色的介面很少來自單一元素。通常是一系列小細節的疊加,造就了卓越的體驗。在建構或審查 UI 程式碼時應用這些原則。
審查時,放慢介面速度:在瀏覽器的「動畫」面板中以 10% 的速度重播動畫,並逐一檢查每個狀態:懸停、聚焦、啟用、載入、空白。在 10% 速度下感覺不對勁的地方,就是全速時細微錯誤的所在。
保留專案的元件庫、設計代碼和間距密度。遵循其既有的動畫語言,除非下列原則規定了特定的互動模式。
排版(文字換行、字型渲染、表格數字、間距)由 better-typography 技能涵蓋;請使用該技能處理任何與文字相關的事項。無障礙性(點擊區域、焦點狀態、鍵盤支援、ARIA、減少動畫)由 better-accessibility 技能涵蓋。佈局結構(分組、區塊間距、斷點、空間 RTL)由 better-layout 技能涵蓋。
快速參考
| 類別 | 使用時機 |
|---|---|
| 表面 | 邊框半徑、光學對齊、陰影、圖片輪廓 |
| 動畫 | 可中斷動畫、進出場過渡、圖示動畫、按壓縮放、動作節制 |
| 圖示 | 圖示筆畫粗細、透過 currentColor 的狀態、輪廓與填滿、尺寸、RTL 翻轉 |
| 效能 | 過渡屬性特異性、will-change 的使用 |
核心原則
1. 同心圓邊框半徑
外層半徑 = 內層半徑 + 內邊距。巢狀元素半徑不匹配是最常讓介面感覺不對勁的原因。
2. 光學對齊優先於幾何對齊
當幾何置中看起來不對時,改用光學對齊。帶有圖示的按鈕、播放三角形和非對稱圖示都需要手動調整。
3. 陰影製造層次,邊框定義結構
對於按鈕、卡片和容器,若其邊框僅為創造深度而存在,則偏好使用多層透明的 box-shadow 值。保留用於傳達結構或狀態的邊框:分隔線、佈局分隔線,以及選中或聚焦狀態。
4. 可中斷動畫
對互動狀態的變化使用 CSS 過渡效果:它們可以在動畫進行中被中斷。保留 keyframes 用於僅執行一次的階段性序列。
5. 分割並交錯進場動畫
對於不頻繁的階段性進場,若順序有助於傳達層級結構,將內容拆分成語意區塊,並以約 100ms 的間隔交錯出現,而不是動畫化整個容器。請不要在常規、高頻率的互動中使用交錯。
6. 微妙的退場動畫
使用一個小的固定 translateY 而不是完整高度。退場應比進場更柔和。進場和退場過渡都使用 ease-out。
7. 情境式圖示動畫
使用 opacity、scale 和 blur 來動畫化圖示,而不是切換可見性。確切使用這些數值:scale 從 0.25 到 1,opacity 從 0 到 1,blur 從 4px 到 0px。如果專案的 package.json 中有 motion 或 framer-motion,則匹配該套件的導入路徑(或兩者都存在時匹配既有的相鄰導入),並使用 transition: { type: "spring", duration: 0.3, bounce: 0 };bounce 必須始終為 0。如果未安裝 motion 庫,則將兩個圖示都保留在 DOM 中(一個絕對定位),並使用 cubic-bezier(0.2, 0, 0, 1) 的 CSS 過渡進行交叉淡入淡出;這可在無需任何依賴的情況下同時實現進場和退場動畫。
8. 圖片輪廓
為圖片添加一個微妙的 1px 低不透明度的輪廓,以獲得一致的深度感。顏色在淺色模式下必須是純黑色(oklch(0 0 0 / 0.1)),在深色模式下必須是純白色(oklch(1 0 0 / 0.1)),絕不能使用接近黑色的顏色,如石板灰、鋅灰或任何帶色調的中性色。帶色調的輪廓會吸收其下方的表面顏色,在圖片邊緣看起來像污漬。
9. 按壓縮放
點擊時微妙的 scale(0.96) 能為按鈕提供觸覺回饋。務必使用 0.96。絕不使用小於 0.95 的值:任何低於此的值都會感覺誇張。添加一個 static 屬性,以便在動畫會分散注意力時將其停用。
10. 頁面載入時跳過動畫
對 AnimatePresence 使用 initial={false} 以防止首次渲染時的進場動畫。確認這不會破壞有意的進場動畫。
11. 絕不使用 transition: all
始終指定確切的屬性:transition-property: scale, opacity。Tailwind 的 transition-transform 涵蓋了 transform, translate, scale, rotate。
12. 節制使用 will-change
僅用於 transform、opacity、filter 這些 GPU 可以合成的屬性。絕不使用 will-change: all。僅在發現首幀卡頓時才添加。
13. 圖示筆畫粗細匹配文字字重
圖示旁的文字會決定其視覺重量:1.5px 筆畫粗細對應常規(400)文字,2px 對應 semibold(600)。每個圖示集使用同一種筆畫粗細;切勿在同一個表面上混用不同的圖示庫。
14. 一個 SVG,按狀態重新著色
圖示使用 currentColor,並透過 CSS 的 color 和 opacity 獲得其狀態(懸停、選中、禁用),而非使用單獨的資源。輪廓變體是預設值;填滿變體表示啟用狀態。
15. 動作節制
對高頻率的互動不要使用自訂動畫:每次觸發都會重複注意力成本。動畫絕不是唯一的回饋通道;每個動畫化的狀態變化也需要一個靜態提示(顏色、圖示、標籤)。
常見錯誤
| 錯誤 | 修正方法 |
|---|---|
| 緊密巢狀的父層與子層使用相同的邊框半徑 | 計算 outerRadius = innerRadius + padding |
| 圖示看起來未置中 | 使用內邊距進行光學調整,或直接修正 SVG |
| 僅用於模擬高度層級的邊框 | 使用帶透明度設定的分層 box-shadow;保留結構性與狀態性邊框 |
| 突兀的階段性進場或情境式退場 | 交錯不頻繁的進場動畫,並保持保留情境的退場動畫微妙 |
| 有狀態的圖示或切換開關在頁面載入時動畫化其預設狀態 | 對該 AnimatePresence 添加 initial={false};保留有意的頁面進場動畫 |
元素上的 transition: all | 指定確切的屬性 |
| 首幀動畫卡頓 | 添加 will-change: transform(節制使用) |
| 細線圖示搭配粗體文字 | 將筆畫粗細匹配文字字重 |
| 每個狀態使用獨立的圖示資源 | 一個使用 currentColor 的 SVG,狀態透過 CSS 控制 |
| 到處都是填滿圖示 | 預設使用輪廓,僅在啟用狀態使用填滿 |
| 每次懸停或按鍵時都進行進場動畫 | 即時回饋或 ≤150ms 的不透明/顏色過渡 |
審查輸出格式
僅在使用者要求進行獨立的 UI 精緻度審查時使用此格式。當 better-interface 協調審查時,請將領域證據和發現提供給該技能,並讓其輸出格式、嚴重性等級、合併規則、上限和最終判定優先適用。
以兩部分呈現獨立的審查結果。
發現
按原則分組所有確認的發現。使用一個帶有 嚴重性、位置、之前、之後 和 原因 欄位的 Markdown 表格。切勿使用獨立的「之前:」/「之後:」行。
- 嚴重性:
HIGH表示使互動產生誤導、無反應或反覆造成干擾;MEDIUM表示造成明顯的工藝或一致性問題;LOW表示孤立的細節問題。 - 位置:引用
path/to/file:line。如果成品沒有原始碼檔案,請引用確切的畫面和元件。 - 之前 / 之後:顯示目前的實作和可行的替代方案。
- 原因:指出違反的原則並解釋其如何影響介面。
將重複的系統性問題合併為一行,並列出所有受影響的位置。省略沒有發現的原則。
範例
同心圓邊框半徑
| 嚴重性 | 位置 | 之前 | 之後 | 原因 |
|---|---|---|---|---|
| LOW | src/Card.tsx:28 | 卡片上使用 rounded-xl + 內部按鈕 (p-2) 使用 rounded-xl | 卡片上使用 rounded-2xl (8 + 8 = 16),內部按鈕使用 rounded-lg | 巢狀角落應為同心圓 |
| LOW | src/card.css:11 | 兩個巢狀表面的 border-radius: 16px | 外層 24px,內層 16px,內邊距 8px | 相等的巢狀半徑會使內部表面看起來被擠壓 |
按壓縮放
| 嚴重性 | 位置 | 之前 | 之後 | 原因 |
|---|---|---|---|---|
| LOW | src/Button.tsx:19 | <button className="..."> | 添加 active:scale-[0.96] transition-transform | 按壓回饋使控制項感覺有反應 |
| MEDIUM | src/button.css:24 | 按壓時 scale(0.9) | 提升為 scale(0.96) | 任何低於 0.95 的值都感覺誇張 |
驗證與最終判定
在發現之後:
- 驗證:列出執行過的精確檢查及其觀察結果。當涉及動畫時,逐一檢查每個相關狀態並以 10% 的速度檢視動畫。如果某項檢查未執行,說明仍需驗證的項目。
- 最終判定:如果仍有任何
HIGH級別的發現,則為Block;如果僅有MEDIUM或LOW級別的發現,則為Needs changes;僅在沒有可處理的發現時才為Approve。
當沒有發現時,省略表格,陳述「無可處理的 UI 精緻度發現」,報告驗證結果,並以 Approve 結束。