Communitygithub.com

motion-ui

指導 AI 如何規劃、建構或精簡「動態 UI」,以產出具設計系統標記的具體成果。流程涵蓋 Motion UI、工作流程、不可妥協原則。當新任務需要這項技術時使用。

motion-ui 是什麼?

Motion UI 是一套以研究為基礎的產品 UI 動態與手勢實戰指南,包含 19 個模式檔案,每個檔案都提供規則、反模式、優劣參考案例、無障礙規範、設計標記、實作草稿與檢查清單。此技能的核心 SKILL.md 檔案定義了完整的工作流程、不可妥協的原則、決策表格以及預設的動態標記。它支援 CSS 過渡、原生彈簧、JavaScript 動畫庫(如 Motion、React Spring)、View Transitions 以及捲動驅動動畫等多種實作機制,並提供從頻率決策到效能審查的完整步驟。使用此技能時,AI 代理會先判斷元素是否需要動態效果,然後根據觸發頻率與機制選擇適當的動畫類型、設定時間參數、編排空間與手勢,最後進行基於影格的低成本審查,確保成果符合無障礙與效能要求。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YehudaBriskman/fUdesIgn/tree/HEAD/plugins/motion-ui/skills/motion-ui

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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-* 模式。此技能不會重複這些內容。

工作流程

  1. 決定它是否應該移動。 命名任務:反饋、連續性、方向感、注意力,或(很少)愉悅感。估算發生的頻率以及是否由鍵盤觸發,然後在下方的頻率表格(mfound-purpose-and-frequency.md)中選擇對應的行。如果沒有任務,或者動作是由鍵盤驅動或每天發生 100 次以上,則停止:不加入動畫。
  2. 選擇機制。
    • 靜止到靜止與切換(選單、對話框、切換開關):使用 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)。
  3. 從標記設定時間參數。 按元素設定持續時間,按方向設定緩動曲線,離開速度為進入的 0.75 倍,彈簧則設定為持續時間加上反彈值。不要在元件中使用原始數值。
  4. 將其放置在空間中。 使用觸發點作為 transform-origin,鏡像離開動畫,保持前進與後退一致,並讓持續存在的 chrome 元素保持靜止(mtrans-spatial-origin-and-continuity.md)。對於頂層元素的進入/離開,請遵循 mtrans-enter-exit-top-layer.md。
  5. 對於手勢,依序應用:
    • 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)。
  6. 編排多個變化的情況:起因優先,然後是父元素,最後是子元素;間隔 20–40 毫秒,並設有上限(mfound-choreography-and-stagger.md)。
  7. 使其輕量化。 僅對 transform 和 opacity 執行動畫,不使用全域的 will-change,並在下一幀中繪製反饋(mperf-compositor-will-change-and-inp.md)。
  8. 撰寫減少動態的版本,使用替代而非刪除(mfound-reduced-motion-vestibular.md)。
  9. 從影格審查。
    • 執行反模式檢查(mref-anti-patterns-gallery.md)。
    • 捕獲影格序列(4 倍慢速播放、完整動態和減少動態版本,以及一次中斷執行的版本)與頁面內審計。
    • 對 18 項檢查清單進行評分(mref-motion-review-rubric.md)。分數達到 80% 或以上且沒有任何必須檢查項目為 0 分時即可發布。
    • 回報每個發現結果,格式為:檢查 ID · 證據 · 修正方案,並列出未檢查的項目。

不可妥協原則

只有在有書面理由的情況下才能打破以下任何一項。

是否動與多久

  1. 每個動畫都有一個命名的任務。鍵盤觸發和每天 100 次以上的操作不應有動畫。
  2. 無論動畫長度為何,第一個視覺回應必須在使用者輸入後 100 毫秒內發生。
  3. 持續時間來自標記(100 / 150 / 240 / 400 毫秒)。UI chrome 中沒有任何內容超過 400 毫秒;只有罕見的時刻可能達到 600 毫秒。
  4. 進入時使用 ease-out;螢幕上的移動使用 ease-in-out;使用者等待的任何東西都不應使用 ease-in。離開動畫的持續時間約為進入動畫的 0.75 倍。

彈簧與手勢

  1. 彈簧以持續時間 + 反彈值表示。UI chrome 使用 bounce 0,僅在具有動量的手勢後使用 0.1–0.2,並且永遠不要在 opacity、顏色或數據值上使用反彈。
  2. 拖曳的元素從抓取點開始 1:1 追蹤指標,拖曳時沒有過渡。大約在 10 px 後確定拖曳。
  3. 釋放時,捕捉到投影位置最近的目標,並以釋放速度啟動穩定彈簧。
  4. 邊緣具有橡皮筋效果;沒有任何東西在使用者手指下硬性停止。
  5. 使用者可以影響的所有內容都可以從當前的螢幕值中斷。沒有動畫佇列,且在動畫期間不會阻止輸入。切換式 UI 使用過渡,而不是關鍵影格。
  6. 破壞性手勢動作在釋放時提交,並提供復原選項。每個手勢都有一個按鈕或鍵盤等效操作(WCAG 2.5.7)。

進入、離開與導航

  1. 永遠不要從 scale(0) 開始。從 opacity 0 加上 scale 0.95–0.97 或 8–24 px 的位移開始進入,並將 transform-origin 設在觸發點。
  2. 使用 @starting-style 進行進入,使用 display/overlay 搭配 allow-discrete 進行離開。可見的最終狀態是預設值,因此不支援的瀏覽器仍然可以運作。
  3. 路由轉場是漸進增強。先準備數據,再進行轉場。根據轉場類型使用預設的交叉淡入或 16–24 px 的方向性位移,命名 1–3 個共享元素,並在之後移動焦點。
  4. Toast 永遠不應是資訊的唯一載體。錯誤訊息永遠不會自動關閉;復原 Toast 至少停留 8 秒,且其動作也存在於 Toast 外部。計時器在懸停、聚焦和隱藏分頁時暫停(dashboard-ui comp-notifications-alerts.md)。

效能與安全性

  1. 對於任何大於小型控件的元素,僅對 transform 系列屬性和 opacity 執行動畫。不使用 transition: all。will-change 是暫時的,並且僅在測量之後使用。
  2. 在 prefers-reduced-motion: reduce 下,用 150 毫秒或更短的淡入動畫取代空間動態,保留反饋,保留 1:1 拖曳追蹤,並移除反彈。永遠不要發布全域的 0.01ms 終止開關,JS 動畫也必須遵守此設定。
  3. 產品 UI 中沒有視差、滾動劫持、全視窗縮放或空轉循環動畫。超過 5 秒的自動播放需要有暫停控制,並且每秒閃爍不超過 3 次。
  4. 從捕獲的影格審查動態,而不是從程式碼或記憶中審查。

決策表格

頻率 → 動態(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-fast0.24 s / 0切換開關、小型控制項
spring-default0.3 s / 0選單、面板穩定、佈局
spring-slow0.45 s / 0全螢幕介面
spring-snappy0.3 s / 0.15輕彈後的釋放、吸附效果
spring-playful0.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、其自身標記)時:以其標記為準。將它們映射到這些角色上,並標記差異。
  • 當規則衝突時: 無障礙和使用者控制(減少動態、可中斷性、無滾動劫持)優先於表現力,頻率優先於愉悅感。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相關技能