Motion UI
一套基於研究、專為產品 UI 動態與手勢設計的實戰指南:包含 19 個模式檔案,每個檔案都有規則、反模式、優劣參考案例、無障礙規範、設計標記、實作草稿與檢查清單。此檔案提供工作流程、不可妥協原則、決策表格以及預設標記。如需深入細節,請開啟模式檔案。
- 模式索引:
references/INDEX.md列出了每個模式及其一句話規則。 - 模式檔案:
references/patterns/<前綴>-<名稱>.md。前綴分為mfound(目的、時機、編排、減少動態)、mspring(彈簧)、mgesture(拖曳、動量、邊緣、面板、中斷)、mtrans(進入/離開、空間起點、路由轉場、微互動、捲動驅動)、mperf(效能)和mref(審查評分表、反模式)。 - 入門標記:
assets/motion-tokens.css。持續時間、緩動曲線與間隔的名稱和值與dashboard-ui的tokens.css相符。它可以在淺色和深色模式下獨立運作:它所讀取的dashboard-ui角色標記以零特異性宣告,因此無論載入順序為何,dashboard-ui的tokens.css或專案自身在相同角色名稱上的標記都會覆蓋它們。 - 資料 UI: 對於數字補間、圖表轉場、連結探索、即時重算與載入狀態,請使用
dashboard-ui的motion-*和prog-*模式。此技能不會重複這些內容。
工作流程
- 決定它是否應該移動。 命名任務:反饋、連續性、方向感、注意力,或(很少)愉悅感。估算發生的頻率以及是否由鍵盤觸發,然後在下方的頻率表格(
mfound-purpose-and-frequency.md)中選擇對應的行。如果沒有任務,或者動作是由鍵盤驅動或每天發生 100 次以上,則停止:不加入動畫。 - 選擇機制。
- 靜止到靜止與切換(選單、對話框、切換開關):使用 CSS 過渡(
mfound-durations-and-easing.md),或使用彈簧linear()標記(mspring-css-linear-and-tokens.md)。 - 由手指或指標驅動,或可被速度中斷:使用 JS 彈簧(
mspring-parameters-and-mapping.md、mgesture-interruptibility-and-velocity.md)。 - 導航:使用 View Transitions(
mtrans-view-transitions-and-routes.md)。 - 與捲動位置綁定:使用捲動驅動動畫(
mtrans-scroll-driven-animations.md)。
- 靜止到靜止與切換(選單、對話框、切換開關):使用 CSS 過渡(
- 從標記設定時間參數。 按元素設定持續時間,按方向設定緩動曲線,離開速度為進入的 0.75 倍,彈簧則設定為持續時間加上反彈值。不要在元件中使用原始數值。
- 將其放置在空間中。 使用觸發點作為
transform-origin,鏡像離開動畫,保持前進與後退一致,並讓持續存在的 chrome 元素保持靜止(mtrans-spatial-origin-and-continuity.md)。對於頂層元素的進入/離開,請遵循mtrans-enter-exit-top-layer.md。 - 對於手勢,依序應用:
- 1:1 追蹤,帶有 10 px 閾值(
mgesture-direct-manipulation-drag.md); - 釋放時的投影與速度(
mgesture-momentum-projection-and-snap.md); - 橡皮筋邊緣效果(
mgesture-rubber-banding-and-bounds.md); - 面板與滑動關閉規則(
mgesture-sheets-and-swipe-to-dismiss.md)。
- 1:1 追蹤,帶有 10 px 閾值(
- 編排多個變化的情況:起因優先,然後是父元素,最後是子元素;間隔 20–40 毫秒,並設有上限(
mfound-choreography-and-stagger.md)。 - 使其輕量化。 僅對 transform 和 opacity 執行動畫,不使用全域的
will-change,並在下一幀中繪製反饋(mperf-compositor-will-change-and-inp.md)。 - 撰寫減少動態的版本,使用替代而非刪除(
mfound-reduced-motion-vestibular.md)。 - 從影格審查。
- 執行反模式檢查(
mref-anti-patterns-gallery.md)。 - 捕獲影格序列(4 倍慢速播放、完整動態和減少動態版本,以及一次中斷執行的版本)與頁面內審計。
- 對 18 項檢查清單進行評分(
mref-motion-review-rubric.md)。分數達到 80% 或以上且沒有任何必須檢查項目為 0 分時即可發布。 - 回報每個發現結果,格式為:檢查 ID · 證據 · 修正方案,並列出未檢查的項目。
- 執行反模式檢查(
不可妥協原則
只有在有書面理由的情況下才能打破以下任何一項。
是否動與多久
- 每個動畫都有一個命名的任務。鍵盤觸發和每天 100 次以上的操作不應有動畫。
- 無論動畫長度為何,第一個視覺回應必須在使用者輸入後 100 毫秒內發生。
- 持續時間來自標記(100 / 150 / 240 / 400 毫秒)。UI chrome 中沒有任何內容超過 400 毫秒;只有罕見的時刻可能達到 600 毫秒。
- 進入時使用 ease-out;螢幕上的移動使用 ease-in-out;使用者等待的任何東西都不應使用
ease-in。離開動畫的持續時間約為進入動畫的 0.75 倍。
彈簧與手勢
- 彈簧以持續時間 + 反彈值表示。UI chrome 使用 bounce 0,僅在具有動量的手勢後使用 0.1–0.2,並且永遠不要在 opacity、顏色或數據值上使用反彈。
- 拖曳的元素從抓取點開始 1:1 追蹤指標,拖曳時沒有過渡。大約在 10 px 後確定拖曳。
- 釋放時,捕捉到投影位置最近的目標,並以釋放速度啟動穩定彈簧。
- 邊緣具有橡皮筋效果;沒有任何東西在使用者手指下硬性停止。
- 使用者可以影響的所有內容都可以從當前的螢幕值中斷。沒有動畫佇列,且在動畫期間不會阻止輸入。切換式 UI 使用過渡,而不是關鍵影格。
- 破壞性手勢動作在釋放時提交,並提供復原選項。每個手勢都有一個按鈕或鍵盤等效操作(WCAG 2.5.7)。
進入、離開與導航
- 永遠不要從
scale(0)開始。從 opacity 0 加上 scale 0.95–0.97 或 8–24 px 的位移開始進入,並將transform-origin設在觸發點。 - 使用
@starting-style進行進入,使用display/overlay搭配allow-discrete進行離開。可見的最終狀態是預設值,因此不支援的瀏覽器仍然可以運作。 - 路由轉場是漸進增強。先準備數據,再進行轉場。根據轉場類型使用預設的交叉淡入或 16–24 px 的方向性位移,命名 1–3 個共享元素,並在之後移動焦點。
- Toast 永遠不應是資訊的唯一載體。錯誤訊息永遠不會自動關閉;復原 Toast 至少停留 8 秒,且其動作也存在於 Toast 外部。計時器在懸停、聚焦和隱藏分頁時暫停(
dashboard-ui comp-notifications-alerts.md)。
效能與安全性
- 對於任何大於小型控件的元素,僅對 transform 系列屬性和 opacity 執行動畫。不使用
transition: all。will-change是暫時的,並且僅在測量之後使用。 - 在
prefers-reduced-motion: reduce下,用 150 毫秒或更短的淡入動畫取代空間動態,保留反饋,保留 1:1 拖曳追蹤,並移除反彈。永遠不要發布全域的0.01ms終止開關,JS 動畫也必須遵守此設定。 - 產品 UI 中沒有視差、滾動劫持、全視窗縮放或空轉循環動畫。超過 5 秒的自動播放需要有暫停控制,並且每秒閃爍不超過 3 次。
- 從捕獲的影格審查動態,而不是從程式碼或記憶中審查。
決策表格
頻率 → 動態(mfound-purpose-and-frequency.md)
| 頻率 | 動態 |
|---|---|
| 鍵盤觸發,或每天 100 次以上(技能的截止點) | 無 |
| 每天數十次 | 100–150 毫秒淡入,可能加上一個小縮放;無移動,無反彈 |
| 每次會話幾次 | 150–240 毫秒,可能移動 8–24 px |
| 罕見(首次執行,重大成功) | 最多 400–600 毫秒,可允許帶反彈的彈簧 |
機制(mspring-parameters-and-mapping.md、mspring-css-linear-and-tokens.md)
| 情況 | 使用方式 |
|---|---|
| 顏色、透明度、狀態變更 | CSS 過渡,linear 或 ease-out |
| 可能在中途反轉的切換元素 | CSS 過渡(永遠不要用關鍵影格) |
| 具有彈簧感覺的靜止到靜止空間動態 | CSS 彈簧 linear() 標記加上其自身的持續時間 |
| 拖曳或輕彈後釋放,或帶速度的重新定位 | JS 彈簧(Motion、React Spring、SwiftUI、Compose) |
| 佈局變更(重新排序、調整大小、展開) | FLIP、Motion layout 或 View Transition |
| 頁面或路由變更 | View Transition(相同或跨文件) |
| 透過滾動容器進行進度 | 捲動驅動動畫 |
依元素區分的持續時間與緩動曲線(mfound-durations-and-easing.md)
| 元素 | 持續時間 | 曲線 |
|---|---|---|
| 按壓、切換、懸停 | 100 毫秒 | ease-out(按壓縮放 0.97) |
| 工具提示、選單、彈出視窗 | 進入 150 毫秒 / 離開 110 毫秒 | 進入 ease-out,離開 ease-in 或淡出 |
| 對話框、Toast | 進入 240 毫秒 / 離開 180 毫秒 | 進入 ease-out,離開 ease-in 或淡出 |
| 面板、抽屜 | 240–400 毫秒 | --motion-ease-drawer,或拖曳後的彈簧 |
| 容器轉換(卡片 → 詳情) | 400 毫秒 | emphasized |
| 路由交叉淡入 | 150–250 毫秒 | linear |
彈簧預設(mspring-parameters-and-mapping.md)
| 標記 | 持續時間 / 反彈 | 用途 |
|---|---|---|
spring-fast | 0.24 s / 0 | 切換開關、小型控制項 |
spring-default | 0.3 s / 0 | 選單、面板穩定、佈局 |
spring-slow | 0.45 s / 0 | 全螢幕介面 |
spring-snappy | 0.3 s / 0.15 | 輕彈後的釋放、吸附效果 |
spring-playful | 0.4 s / 0.3 | 僅限罕見的愉悅感效果 |
程式庫參數(Motion、React Spring、SwiftUI、Material 3)來自 mspring-parameters-and-mapping.md 中的一個公式。
手勢閾值(mgesture-*)
| 數值 | 預設值 |
|---|---|
| 拖曳開始 / 軸鎖定 | 10 px |
| 速度取樣視窗 | 100 毫秒 |
| 投影減速度 | 每次 0.998(快速翻頁為 0.99) |
| 輕彈確認 | > 400 px/s |
| 面板關閉 | 拖曳超過其高度的 25%,或一個輕彈 |
| 橡皮筋常數 | 0.55(常用近似值) |
標記預設值
完整設定在 assets/motion-tokens.css 中。
| 群組 | 預設值 |
|---|---|
| 持續時間 | instant 0 · micro 100 · short 150 · medium 240 · long 400 毫秒 · 離開比率 0.75 |
| 緩動曲線 | standard cubic-bezier(0.2,0,0.38,0.9) · enter (0,0,0.38,0.9) · exit (0.2,0,1,0.9) · emphasized (0.2,0,0,1) · drawer (0.32,0.72,0,1) |
| 彈簧(CSS) | --motion-spring-{fast,default,slow,snappy,playful} 搭配對應的 -dur(360 / 450 / 670 / 420 / 660 毫秒) |
| 幾何 | scale-from 0.96 · press 0.97 · distance 8 / 16 / 24 px |
| 編排 | stagger 30 毫秒 · max 300 毫秒(選單中為 150 毫秒) |
| 減少動態 | 空間標記歸零或為 1;淡入動畫保留其時間 |
如何應用此技能
- 建構時:
- 載入
assets/motion-tokens.css,或將其映射到專案的標記上。 - 優先使用平台功能:CSS 過渡、
@starting-style、<dialog>與彈出視窗 API、View Transitions、捲動驅動動畫、linear()。僅在手勢和速度需要時才使用 JS 庫。 - 永遠不要使用 TypeScript 的
any型別。
- 載入
- 審查時: 先捕獲影格,然後執行反模式圖庫和評分表。回報一個按嚴重性排序的表格,內容包含檢查項目、分數、證據和修正方案,並列出未檢查的項目。
- 當專案已有動態系統(M3、Carbon、其自身標記)時:以其標記為準。將它們映射到這些角色上,並標記差異。
- 當規則衝突時: 無障礙和使用者控制(減少動態、可中斷性、無滾動劫持)優先於表現力,頻率優先於愉悅感。