介面質感 是做什麼的?
關於介面如何移動與回應的全面檢視。它會針對應用程式的當前狀態,逐一比對清單中的四十個項目(十二個動畫原理、八個 UX 法則、二十個 UI 技巧)與運動系統,撰寫一份報告,然後根據每個項目的修正模式來修復發現的問題。大多數應用程式已經擁有清單中的一半項目;審計報告會指出這點,而不是重複添加。速度、目標區域與信任感永遠適用;裝飾性元素在工作工具中應保持克制。
專案自身的設計系統、運動 token 與規則優先於此處的任何內容。效能預算(LCP、INP、套件大小)、無障礙性與文案是與此技能並行的獨立檢查。
此技能包含的檔案
| 檔案 | 用途 |
|---|---|
reference.md | 40 個項目的詳細說明:如何檢查、修復模式、何時跳過、以及真實審計範例 |
motion.md | 運動系統:token、十二條規則、CSS 模式、如何審計動畫 |
audit/census.sh | 程式碼普查:計算每個項目對應的模式數量,並附帶檔案:行號的線索 |
audit/probe.js | 即時頁面探測:真實的點擊目標、持續時間、緩動函數、圖形、標題、代碼欄位、佔位符 |
report-template.md | 審計報告範本:每個項目一行結論、工作順序、未檢查的內容 |
第一階段:審計(不修改任何內容)
- 首先閱讀專案的設計系統、運動 token 與 UI 規則。
- 從專案根目錄執行普查:
bash <此技能的路徑>/audit/census.sh . --show 5。它只會讀取已發布的原始碼(排除依賴項目、建置產物、複製的程式碼、測試、基準測試、產生的檔案與註解行;可使用CENSUS_EXCLUDE="dir1,dir2"加入更多排除項目)。安裝 ripgrep 以獲得快速執行;若沒有,腳本會回退使用 perl。計數僅代表需要檢查的線索,而非最終判定。 - 執行應用程式。在每個關鍵頁面上,於寬度 1440px 與 375px 下,以及在應用程式提供的每個主題中,執行
audit/probe.js(將其貼到主控台,或在瀏覽器工具的 JavaScript 執行器中await它)。它會一次一個畫面地捲動整個頁面,然後恢復位置。隱藏的分頁沒有寬度且不會繪製畫面:請先顯示它。判斷其輸出:標記為spaced(與下一個控制項的間隙達到最小值)的目標嚴重性較低;圖形僅在數值變化時才需要tabular-nums;將裝飾性的假視窗標記為aria-hidden,或忽略其列。 - 手動檢查腳本無法看見的項目,使用真實的指標事件(瀏覽器工具的點擊,非合成的
.click()):快速按下每個付費或不可逆的操作兩次,並計算伺服器端的影響;將網路與寫入操作限速至 600 毫秒再按下;快速開啟與關閉每個圖層,並在關閉過程中重新開啟,取樣其不透明度(motion.md中的「Measuring a reopen」);在關閉的選單內點擊;輸入帶有重音符和不同大小寫的查詢;沿對角線朝懸停子選單移動;在圖層開啟時按下 Android 返回鍵;滑動關閉手機的 sheet。 - 根據
report-template.md撰寫報告:所有 40 行,每個項目標記為 存在、遺漏、錯誤 或 跳過,並附上理由、檔案:行號或數字的證據,以及標註為 建置 或 挑選。在修復前展示報告。
第二階段:根據檢查清單修復
- 信任優先:第 39 項以及任何可能導致雙重收費或資料遺失的項目,並在修復前撰寫一個會失敗的測試。
- 建置 項目:這些項目改變行為但不改變外觀(例如:點擊區域偷渡、安全三角形、返回手勢、強調色折疊、快捷鍵、命令面板條目、樂觀寫入、骨架屏、運動 token、可逆轉場)。根據
reference.md和motion.md中的模式,透過專案自己的元件和 token 來修復每個項目,並為任何邏輯撰寫測試。 - 挑選 項目:這些項目改變外觀或產品(例如:圓角、模糊佔位符、替代確認對話框的復原提示、錯誤警示、新的動畫節拍、視角轉場)。每個項目需在兩種主題下以 1:1 比例進行前後對比評估,並編號且可分離;只建置被負責人挑選的項目。
- 絕不以移除既有裝飾來換取新的裝飾。
第三階段:驗證
重新執行普查與探測,並將結果與報告進行比較。以使用者的方式,在兩種主題下以及手機寬度下,單獨測試每個已修復的互動。將已建置、已測試、已通過視覺審查和已部署的項目作為獨立的事實報告,並說明哪些內容無法測量(例如:沒有實體手機、沒有正式建置版本)。
檢查清單
編號與 reference.md 及報告相符。
| # | 項目 | 失敗條件 |
|---|---|---|
| A | 動畫原理 (motion.md) | |
| 1 | 擠壓與拉伸 | 著陸的徽章、圓點或旋鈕停止時毫無緩衝 |
| 2 | 預備動作 | 按下動作在一個影格內沒有狀態變化(縮放至約 0.97,持續約 100 毫秒) |
| 3 | 聚焦 | 開啟的圖層未能讓主要事物保持清晰 |
| 4 | 姿態到姿態 | 忙碌的按鈕、標籤或圖示切換時,寬度或內容發生跳躍 |
| 5 | 跟隨動作 | 圖層的內容像是黏在容器上一同到達 |
| 6 | 慢入慢出 | UI 動畫使用 linear 或預設的 ease;使用超過三種緩動函數 |
| 7 | 弧線運動 | 某個物體以直線方式移動很長距離 |
| 8 | 次要動作 | 一個完成的動作沒有確認性的第二個動畫節拍 |
| 9 | 節奏明快 | UI 回應時間超過 300 毫秒;同一個表層的表現不一致;退出動畫不比進入動畫短 |
| 10 | 誇張反饋 | 無效的提交僅顯示微小的顫動,沒有顏色變化的節拍 |
| 11 | 立體繪圖 | 陰影與圖層在光線和深度上不一致 |
| 12 | 吸引力 | 以 1:1 比例逐步操作一個真實流程時,顯示出接縫 |
| B | UX 法則 | |
| 13 | 費茲定律 | 桌面端真實目標小於 32px,或手機端小於 44px |
| 14 | 更大的點擊區域 | 目標透過放大圖片來增大,或導致兄弟元素重疊 |
| 15 | 希克定律 | 一個選單區塊中超過五個項目 |
| 16 | 米勒定律 | 未分組的頂層項目超過約七個 |
| 17 | 多赫提定律 | 從按下到下次繪製超過 400 毫秒,且沒有其他東西先回應 |
| 18 | 波斯特爾定律(寬容原則) | 查詢的重音符號、大小寫或間距變體找不到任何結果 |
| 19 | 雅各布定律(慣例原則) | 模式行為與其平台不一致(例如:懸停子選單、返回鍵關閉圖層) |
| 20 | 使用頻率 | 每日操作需要超過一個步驟或一個命令 |
| C | 速度與反饋 | |
| 21 | 骨架載入器 | 路由在點擊的影格上顯示空白或旋轉器 |
| 22 | 樂觀更新 | 一個便宜的、可逆的寫入操作在伺服器回應前未顯示任何內容 |
| 23 | 命令面板 | 某個目標可透過點擊到達,但無法透過打字搜尋 |
| 24 | 快捷鍵提示 | 有快捷鍵的控制項未在其工具提示中顯示 |
| 25 | 復原提示 | 可復原的刪除操作沒有提供復原選項(由負責人決定是否取代確認對話框) |
| 26 | 先顯示過期資料再驗證 | 重新訪問的頁面在顯示最新資料前,未先顯示上一次的資料 |
| 27 | 預渲染 | 最可能前往的下一個頁面,在偵測到意圖時未被預先擷取(需在正式環境中判斷) |
| 28 | 模糊佔位符 | 載入中的圖片顯示為灰色方塊 |
| 29 | 視角轉場(View Transitions) | 從網格到詳細頁面的開啟動作沒有共享元素的變形 |
| 30 | 滑動關閉 | 手機上的 sheet 或抽屜無法透過滑動手勢關閉 |
| 31 | 可中斷動畫 | 在退出動畫播放期間重新開啟,動畫會從頭播放 |
| D | 平台與細節 | |
| 32 | 預測性返回 | Android 返回鍵在圖層開啟時會離開頁面 |
| 33 | 點擊區域偷渡 | 小型圖示控制項沒有提供不可見的目標區域擴展 |
| 34 | 安全區域內邊距 | 底部浮動元素在 viewport-fit=cover 設定下,忽略了 env(safe-area-inset-*) |
| 35 | 一次性代碼自動填寫 | 驗證碼輸入欄位缺少 autocomplete="one-time-code" 與 inputmode="numeric" |
| 36 | 表格數字 | 變化中的數字會跳動(未使用 tabular-nums) |
| 37 | 平衡標題 | 短的多行標題會產生孤兒字(未使用 text-wrap: balance) |
| 38 | 連續圓角 | 未考慮使用 squircle 圓角(這是一個外觀決策:需要對比評估) |
| E | 信任 | |
| 39 | 冪等金鑰 | 快速按下付費或不可逆的操作兩次,會對伺服器造成兩次影響 |
| 40 | 安全三角形 | 當滑鼠沿對角線移向懸停子選單時,它會關閉 |
常見錯誤
- 添加已存在的內容:骨架屏、快取與運動 token 通常已經存在;結論應為存在。
- 僅依賴客戶端去重作為安全機制:在重新渲染禁用按鈕前,兩次點擊已經送達。應在伺服器端進行防護(條件更新、確定性金鑰、鎖定),並在 ref 中記錄按壓狀態。
- 放大圖片而非目標區域;僅在桌面端寬度檢查目標,而桌面端的規則卻覆蓋了手機端的最小目標尺寸。
- 為開啟和關閉設定不同的關鍵影格:無法反轉。應使用狀態屬性的轉場效果,並將正在離開的圖層設為
inert。 - 將復原、圓角或錯誤提示音視為純工程選擇。這些屬於負責人的產品決策。
- 在開發伺服器或後台分頁上判斷預先擷取或時間設定。