Communitygithub.com

antheo-motion

決定元素是否該移動,並賦予精確的時機、緩動曲線與距離(按壓、懸停、選單、對話框、面板、拖曳、頁面過渡),同時處理減少動畫需求。當 UI 感覺卡頓、僵化或過度設計,或抽屜、拖曳行為不對勁時,或在上線任何動畫之前使用。

antheo-motion 是什麼?

Antheo Motion 是一款針對 UI 動畫的專業技能,它強制執行一套嚴謹的決策流程:先列出螢幕上的所有變化,評估其出現頻率,再從預先定義的持續時間與緩動曲線表單中選擇合適的參數,最後支援減少動畫模式。它明確區分頻繁出現的微互動(如選單、提示框,持續時間不超過 150 毫秒)與罕見的「簽名時刻」(由另一個技能 antheo-moment 處理),並禁止使用 `transition: all`、`width` 或 `height` 等昂貴屬性,只允許 `transform` 與 `opacity`。技能包含檢查清單、自動化腳本(`filmstrip.mjs` 可將動畫減速至 0.1 倍並輸出逐格影像以進行視覺審核),以及一系列參考文件(如配方、手勢、彈簧、效能等)。它支援 Claude Code、Cursor 與 Codex 等平台,幫助開發者產出流暢、可中斷且無障礙的 UI 動畫。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/antheo-design/skills/tree/HEAD/skills/antheo-motion

在你喜歡的 AI 中提問

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

說明文件

Antheo Motion

動畫是關於變化的資訊:某個東西抵達、離開、移動或回應了你。什麼都沒解釋的動畫是雜訊;沒有動畫的變化則是一次跳躍。這個技能決定哪些變化需要移動,並為每個變化賦予精確的時機。元件的單一「簽名時刻」屬於 antheo-moment;持續時間代碼由 antheo-tokens 產生;減少動畫需求則由 antheo-access 檢查。審計、刪減或規劃整個應用程式的動畫是 antheo-motion-audit 的工作。

依此順序決定

  1. 列出螢幕上的每一個變化:什麼東西開啟、關閉、出現、離開、重新排序、更新、載入、成功或失敗。
  2. 標記每個人看到它的頻率:一天多次、每天一次或很少。
  3. 從下方的表格為每個變化指定持續時間與緩動曲線。
  4. 將唯一罕見、有意義的事件(如果有的話)交給 antheo-moment。
  5. 快速檢查兩次,並檢查減少動畫模式,然後拍攝並讀取每一幀(見下方)。

說明它為何移動,否則就不要移動

「這個東西移動是為了讓人理解 ___。」無法完成這個句子:就不要有動畫。

越常被看到,它移動得越少

頻率它獲得
一天多次(打字、行、分頁、選單、調色盤)最多 150 毫秒,移動 4px;用鍵盤操作時,只給一個短淡出
每天一次(對話框、面板、提示訊息、儲存)一個短暫的進場和更快的出場,150 到 300 毫秒
很少(第一次成功、訂單成立)唯一一個可以放簽名時刻的地方(antheo-moment)

持續時間,依工作類型

Token值適用場合
--dur-instant100 毫秒顏色與透明度的回饋
--dur-fast150 毫秒按壓、進入與離開懸停、選單或工具提示開啟
--dur-base200 毫秒東西離開、對話框關閉、數值或文字切換、提示訊息到達
--dur-open250 毫秒對話框開啟、分頁、手風琴、卡片調整大小
--dur-slow300 毫秒面板或抽屜升起、標記橫向滑動
--dur-page400 毫秒頁面或共享元素過渡

介面動畫保持在 300 毫秒或以下;頁面移動在 400 毫秒或以下。旋轉器、進度條和與滾動相關的動畫使用 linear。

開啟與關閉,成對出現

項目開啟關閉
選單、彈出式視窗、選擇器150 毫秒,從 scale(0.97) 和淡入開始,從觸發點開始120 毫秒
工具提示延遲 400 毫秒,然後 150 毫秒淡入;如果另一個工具提示在 300 毫秒內關閉,則立即顯示立即
對話框250 毫秒:上升 8px、淡入、從 0.96 縮放200 毫秒
面板、抽屜從它的邊緣開始 300 毫秒,整個過程完全不透明(無淡出、無模糊)200 毫秒
提示訊息200 毫秒,上升 12px200 毫秒,以來的方向離開
手風琴、高度展開250 毫秒,從 grid-template-rows: 0fr 到 1fr200 毫秒

絕對不要延遲關閉或離開懸停:縮短持續時間即可。

一個用於到達與離開的曲線

--ease-out cubic-bezier(0.23, 1, 0.32, 1) 用於所有進入或離開的東西。--ease-in-out cubic-bezier(0.77, 0, 0.175, 1) 只用在某物從螢幕上一個位置移動到另一個位置。--ease-in 只用在某物被永久丟棄時。離開比進入更快,移動距離大約只有一半。

小距離,絕不從零開始

數值切換或彈出式視窗移動 4px,對話框 8px,提示訊息 12px,主角元件 24px;僅面板使用整個邊緣。從 scale(0.96)(選單用 0.97,工具提示用 0.98)且透明度為 0 開始進入,絕不從 scale(0) 開始。文字或圖示切換時模糊 4px,大型表面模糊 8px,200 毫秒以下的交叉淡入模糊 2px。

哪些屬性可以動畫化

預設情況下,只使用 transform 和 opacity(以及顏色);短時間的 filter 模糊、clip-path,以及在需要時,用於高度展開的 grid-template-rows。永遠不要使用 transition: all,永遠不要使用 width、height、top、left 或 margin,也永遠不要直接使用 box-shadow:把變化的陰影放在一個偽元素上並淡入淡出。只有經 profile 分析後才使用 will-change。

從觸發點生長

選單和彈出式視窗的 transform-origin 設在觸發點(Radix 暴露了 --radix-popover-content-transform-origin);模態框保持居中;面板從它所處的邊緣進入;共享元素(例如展開成其頁面的卡片)在每一側使用一個 view-transition-name。

狀態變化使用轉場,一次性動畫使用關鍵幀

任何使用者可以切換的東西都使用 CSS 轉場或彈簧,它們可以在中途反轉;關鍵幀只用於只播放一次的動畫。

交錯 30 到 40 毫秒,前八個,總共 300 毫秒

主角元件的三到六個部分使用 60 到 80 毫秒。永遠不要交錯頻繁開啟的東西,並且在項目到達時不要阻止點擊。

只有用手移動的地方才使用彈簧

開關旋鈕、釋放的拖曳、滑動的分段按鈕。控制元件上的彈跳為 0 到 0.2(超調保持在軌道內),罕見的慶祝動畫最多 0.45;最多一次晃動。拖曳時用無轉場的方式跟隨手指,並在釋放時從釋放速度開始彈簧運動;如果輕彈速度快於約 0.11px/毫秒,或者已經移動了 min(64px, 15%) 的高度,則面板關閉,否則彈回(references/gestures.md)。

沒有任何跳躍

每個變化的值都應該被看到在變化;移除的行關閉其間隙;為將出現的內容保留空間(版面偏移低於 0.1)。載入時,最多一個進場動畫。切換主題時,關閉一幀的轉場效果。

減少動畫模式將故事保留在淡入淡出中

在 prefers-reduced-motion: reduce 下,移動、縮放、模糊、視差和彈跳變成 150 到 200 毫秒的透明度交叉淡入淡出;開關旋鈕立即移動;自動播放的循環停止。任何自行移動超過 5 秒的東西都有一個暫停控制(WCAG 2.2.2);沒有東西每秒閃爍超過 3 次(2.3.1)。

在整個應用程式中

  1. 找出: 一張列出每個變化、其被看到的頻率、目前如何移動、以及應該如何移動的表格。
  2. 改善: 為每個數字使用代碼、補上缺失的離開動畫、將 transform-origin 設在觸發點、一次只處理一個模式。
  3. 移除: 任何在每次載入時都動畫化、在一天多次的操作上播放、延遲下一個操作、在使用者閱讀時循環、或在常規操作上超過 300 毫秒的東西。不確定時,就移除。
  4. 批准或阻止: 一個原因說明句、僅使用代碼、僅使用允許的屬性、離開比進入更快、處理好減少動畫模式、以正常速度和 4 倍 CPU 降速觀看。

檢查它

快速點擊所有東西兩次:它會反轉,絕不跳躍。打開選單二十次:仍然快速。將 CPU 降速 4 倍:仍然流暢。開啟減少動畫模式:沒有任何東西移動。

觀看它:靜態畫面無法判斷動畫

處於靜止狀態的螢幕截圖無法說明某物如何移動,而且每個檢查者都讀取靜態幀。所以,在認為完成之前,請拍攝你製作的每個動畫並查看每一幀:

node <antheo-motion>/scripts/filmstrip.mjs <url> --clip ".tuner" --click ".preset" --duration 600
node <antheo-motion>/scripts/filmstrip.mjs <url> --clip ".sheet" --drag ".handle" --by 0,240 --duration 900

它將頁面減速到 0.1 倍(CSS、Web Animations 和 JavaScript 時鐘),執行那一個動作,並將元素的 12 個幀排列在一張紙上,每個幀都帶有其時間戳。打開紙張並讀取每一幀:

  • 每一幀看起來都是獨立構圖的:沒有硬邊滑過,沒有錯誤顏色的閃爍,沒有空盒子
  • 每個變化的值都被看到在變化:一個應該滾動的數字不會在其指針仍在移動時瞬間切換
  • 中途沒有任何東西回流或跳躍;第一幀已經回應了按壓
  • 結束位置停留在它應該在的地方:彈簧稍微超調並返回,控制元件不會突然停止
  • 使用 --reduce 和 --dark 再次拍攝:故事仍然被講述,而且深色模式下沒有亮色的閃爍

修復幀顯示的任何問題,再次拍攝,並保留最後一張紙作為證據。

生成式 UI 在這裡會犯的錯

在認為完成之前,檢查 references/habits.md 中的每一項:transition: all · 內容在腳本揭示之前被隱藏 · 一個籠統的減少動畫重置 · 一個淡入或滑入的焦點環 · 表現動畫 · 在不可點擊的東西上的懸停效果 · 一個讀取了未定義名稱的轉場。

什麼時候更多的動畫是對的

目的和頻率規則決定;這些數字是預設值。遊戲、創意工具、學習產品或使用者要求品牌時刻時,可以移動得更多、更久。它仍然立即回應輸入,永不阻擋下一個動作,可以在中途被打斷,尊重減少動畫模式,並顯示其代價:無論風格如何,在中階手機上出現慢速幀都是一個發現。

完成

  • 每個變化都已列出並標記了被看見的頻率;頻繁出現的幾乎不移動;鍵盤操作不移動
  • 持續時間和緩動曲線來自代碼;使用上方的開啟/關閉配對;沒有延遲的關閉
  • 只使用允許的屬性;transform-origin 在觸發點;沒有任何東西從 scale(0) 開始
  • 減少動畫模式變成交叉淡入淡出;超過 5 秒的循環可以暫停
  • 快速點擊兩次、在 4 倍降速和減少動畫模式下測試過
  • 每個動畫都已拍攝(scripts/filmstrip.mjs),閱讀了淺色、深色和減少動畫模式下的每一幀
  • 根據 references/habits.md 中的每一項習慣檢查過

檔案

  • scripts/filmstrip.mjs:將一個動畫以 0.1 倍速拍攝成一張幀圖,每幀下方有時間戳
  • references/recipes.md:36 個即用配方的索引,每個配方在 references/recipes/ 中有一個檔案,從按壓和彈出式視窗到數字滾動和串流文字
  • references/why.md:每個規則背後的原因,當某個值看起來隨意或有人想打破它時使用
  • references/gestures.md:拖曳、滑動、面板、吸附點、動量、橡皮筋效果(手機感覺:antheo-mobile)
  • references/choreography.md:多個元素作為一個變化:關閉間隙、重新排序、調整面板大小、交叉淡入淡出
  • references/springs.md:用白話解釋的彈簧、預設、一個 30 行的 JS 彈簧、帶有回退的 linear()
  • references/performance.md:什麼是廉價的動畫、在廉價手機上達到 60fps、如何進行效能分析
  • references/advanced.md:3D、由滾動驅動的動畫、View Transitions、拍攝動畫
  • references/vocabulary.md:從白話描述到模式名稱再到配方
  • references/motion-kit.css:產生的 motion.css 的回退副本
  • references/habits.md:生成式 UI 在這裡會犯的錯,每個都有其修正方法

相關技能