Communitygithub.com

subtle-motion

為任何網站(純 HTML/CSS、React、Next、Vue、Svelte、Astro)添加細膩且精緻的動畫效果,使其感覺更流暢自然,卻不顯刻意,並在低階手機上保持 60fps 的流暢度且無卡頓。

subtle-motion 是什麼?

這個 AI 技能提供了一套嚴謹且可執行的規則,用於在網頁 UI 中添加不突兀、高效能的微互動與動畫。它融合了迪士尼動畫十二原則(如擠壓與拉伸、預備動作、跟隨動作)以及 UX 定律(費茲定律、希克定律、米勒定律等),確保每一處動畫皆有目的且順暢。此技能支援所有主流前端框架(React、Next、Vue、Svelte、Astro)及純 HTML/CSS 網站,並強制要求僅對 `transform` 與 `opacity` 進行動畫,以維持 60fps 的高效能。它建立了一套全域的 CSS Token 系統,涵蓋了按壓、切換、卡片懸浮、卷軸揭示、錯誤抖動等多種通用模式,並嚴格處理 `prefers-reduced-motion` 輔助功能需求。開發者可直接套用這些模式,無需額外引入動畫庫,讓動畫成為一種自然的「調味料」,而非侵入性的花招。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/noni-was-taken/subtle-motion/tree/HEAD/skills/subtle-motion

在你喜歡的 AI 中提問

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

說明文件

精緻動畫 (Subtle Motion)

動畫如同調味料。使用者應感受到網站「流暢」,而非「注意到動畫」。 靈感來源:迪士尼的《生命的幻象》、Jon Yablonski 的《UX 定律》、Raphael Salaja 的 userinterface.wiki、Emil Kowalski(使用頻率原則)。

鐵律(切勿違反)

  1. 僅對 transform 和 opacity 進行動畫(偶爾可用 filter/clip-path)。絕不對 width、height、top、left、margin、padding、box-shadow 大小或 font-size 進行動畫。需要陰影變化?淡入淡出偽元素的 opacity。
  2. 節奏明快:UI 動畫低於 300ms。 按壓 80–120ms,懸浮 150ms,進入 200–300ms,離開 ≈ 進入時間的 70%。僅一次性英雄動畫可延長至 500ms。
  3. 距離要小。 位移 2–16px,縮放 0.97–1.03,旋轉 ≤ 6°。距離過大就會顯得「刻意的動畫」。
  4. 慢入慢出。 移動時絕不使用 linear。進入時用 ease-out,離開時用 ease-in。
  5. 使用頻率:越常使用的元素,動畫越少。 鍵盤導航、命令面板、每天使用 100 次的頁籤、列表選擇:瞬間(0ms)或 ≤100ms 的淡入淡出。對首次使用或稀有時刻進行動畫,而非重複操作。
  6. 多赫蒂門檻:在 100ms 內回應,在 400ms 內完成。 回饋(按壓狀態、等待狀態)應在輸入發生的同一幀開始。任何超過 400ms 的操作都應顯示進度。
  7. prefers-reduced-motion: reduce 會關閉所有移動效果。 透明度淡入淡出可以保留。
  8. 懸浮效果僅在 @media (hover: hover) 下啟用。 觸控裝置否則會產生粘性懸浮。
  9. CSS優先,無需動畫庫,除非專案已導入。能用 CSS 解決就不用 JS 循環。
  10. 切勿延遲或隱藏內容。 揭示動畫不能因為 JS 失敗而隱藏內容、阻擋點擊,或在頁面載入時對 LCP 元素進行動畫。
  11. 分鏡:同一時間只有一個焦點動畫。 每個頁面最多約 5 個動畫接觸點;絕不能有兩個動作在同一時刻爭奪視線。
  12. will-change 僅在動畫期間使用(或 ≤3 個持續性元素上)。
  13. 預設可被中斷。 可中途切換狀態(懸浮、切換、開關、頁籤指示器)應使用 transition,因為它能從當前位置重新定位目標。@keyframes 僅用於一次性瞬間(抖動、響鈴、發送),這些動作需要乾淨地重新開始。
  14. 根據大小和觸發者調整時長。 小元素比大元素快(圖示 100ms,卡片 250ms,面板 300ms)。使用者觸發 = 立即;系統觸發(Toast、背景更新)可使用較慢的極限。
  15. 閃爍次數不超過 3 次/秒;任何循環超過 5 秒需有暫停控制(或者不要循環)。

原則,化為 UI 規則

選擇符合該接觸點的原則;切勿一次全部套用。每個原則對應下方的一個模式。

#原則在 UI 中的含義模式
1擠壓與拉伸物體在撞擊時壓縮,在運動時拉伸:重量感按壓, 切換
2預備動作在主要動作前(發送、提交、彈出)的小幅後拉發送按鈕
3分鏡引導視線集中一處:調暗同級元素,一次一個動畫卡片焦點
4姿勢到姿勢定義開始/結束狀態;讓瀏覽器進行補間transition,而非逐幀 JS
5跟隨動作主要動作停止後,其他部分再穩定下來(小幅超調)Toast, 徽章
6慢入慢出加速和減速,絕不恆定速度Token
7弧線移動元素沿曲線運動,而非直線飛入購物車
8次要動作支援主要動作的小巧點綴成功光環
9節奏明快時長決定感覺;UI < 300msToken
10誇張的回饋超越真實感以強化瞬間(錯誤、成功)錯誤抖動
11實體繪畫 / 3D為平面事物賦予深度和立體感傾斜卡片
12吸引力所有細節的總和,在整個網站中保持一致驗證通過
UX 定律動畫結果模式
費茲定律越大、越近的目標越快點到點擊區域
更大的點擊區域可點擊區域 ≥ 44×44px,即使視覺元素較小點擊區域
希克定律選擇越多,決定越慢;不要一次對多個選項進行動畫交錯上限
米勒定律將內容分塊(約 7 個項目);分組揭示,而非逐項揭示交錯上限
多赫蒂門檻<100ms 回饋,<400ms 總時長,否則顯示進度等待狀態
波斯特爾定律接受雜亂輸入,回傳乾淨輸出;優雅地對清理過程進行動畫輸入格式
雅各布定律使用慣例動畫(選單從觸發器彈出,模態框從中心淡入+縮放)覆蓋層
使用頻率頻繁使用 = 較少動畫規則 5

工作流程

  1. 先閱讀網站。 框架、CSS 方法(Tailwind、CSS Modules、純 CSS)、現有動畫和 Token。重複使用它們。
  2. 將每個互動元素按使用頻率分類:罕見(註冊、結帳、成功)、偶爾(卡片、區塊、模態框)、頻繁(導航、頁籤、面板、列表行)。頻繁的給 ≤100ms 或無動畫。
  3. 選擇 ≤5 個接觸點,按感覺/成本排序:
    1. 按鈕/連結:按壓擠壓 + 點擊區域(原則 1、費茲定律)
    2. 表單回饋:錯誤抖動、成功光環、等待狀態(原則 10、8、多赫蒂門檻)
    3. 卡片:懸浮升起、可選傾斜(原則 11)
    4. 區塊:卷軸揭示、分塊交錯(原則 6、米勒定律)
    5. 覆蓋層/Toast:進入/離開 + 跟隨動作(原則 5、雅各布定律)
  4. 一次性全域添加 Token。
  5. 僅對所選接觸點套用模式。
  6. 驗證(最後一節)。未驗證不算完成。
  7. 報告:每個接觸點附上檔案:行號、套用的原則以及如何觀察。

Token(一次性全域添加)

:root {
  --ease-out: cubic-bezier(.23, 1, .32, 1);       /* 進入、懸浮 */
  --ease-in: cubic-bezier(.55, 0, 1, .45);        /* 離開 */
  --ease-in-out: cubic-bezier(.65, 0, .35, 1);    /* 在螢幕上移動 */
  --ease-settle: cubic-bezier(.34, 1.4, .64, 1);  /* 跟隨動作:約 4% 超調 */
  /* 彈簧感、可中斷;不支援 linear() 的瀏覽器會回退到 `ease` */
  --ease-spring: linear(0, .07 3%, .29 9%, .62 18%, .86 28%, 1.01 40%, 1.03 50%, 1.015 65%, 1);
  --dur-press: 100ms;
  --dur-fast: 150ms;
  --dur-base: 250ms;
  --dur-slow: 300ms;
  --rise: 8px;
}
@media (prefers-reduced-motion: reduce) {
  :root { --rise: 0px; }
  *, *::before, *::after {
    animation-duration: 1ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 1ms !important;
    scroll-behavior: auto !important;
  }
}

是 Tailwind 專案?將這些放入 @theme / tailwind.config 的 extend 中,而非新的 CSS 檔案。

模式

按壓:擠壓 (1) + 點擊區域 (費茲定律)

.btn {
  position: relative;
  transition: transform var(--dur-fast) var(--ease-out), background-color var(--dur-fast) var(--ease-out);
}
@media (hover: hover) { .btn:hover { transform: translateY(-1px); } }
.btn:active { transform: scale(.97); transition-duration: var(--dur-press); }

/* 小圖示按鈕:擴大點擊區域,而非視覺區域 */
.icon-btn { position: relative; }
.icon-btn::before { content: ""; position: absolute; inset: 50% auto auto 50%; width: 44px; height: 44px; translate: -50% -50%; }

切換:擠壓與拉伸 (1)

按鈕在移動時拉伸,到位後穩定。

.switch .knob { transition: transform var(--dur-base) var(--ease-settle); }
.switch[aria-checked="true"] .knob { transform: translateX(20px); }
.switch:active .knob { transform: scaleX(1.2); transform-origin: left; }
.switch[aria-checked="true"]:active .knob { transform: translateX(20px) scaleX(1.2); transform-origin: right; }

發送 / 提交:預備動作 (2)

僅用於罕見的「提交」動作。先後拉 2px,再前進。

@keyframes send { 0% { transform: none } 30% { transform: translate(-2px, 2px) } 100% { transform: translate(24px, -24px); opacity: 0 } }
.send.is-sending svg { animation: send 280ms var(--ease-in-out) forwards; }

卡片焦點:分鏡 (3)

@media (hover: hover) {
  .grid:has(.card:hover) .card:not(:hover) { opacity: .6; }
}
.grid .card { transition: opacity var(--dur-base) var(--ease-out); }

僅用於密集網格且單一選擇重要的情境。在閱讀內容時跳過。

卡片升起 + 可選傾斜:實體繪畫 (11)

.card { position: relative; transition: transform var(--dur-base) var(--ease-out); }
.card::after {
  content: ""; position: absolute; inset: 0; border-radius: inherit; pointer-events: none;
  box-shadow: 0 12px 32px -12px rgb(0 0 0 / .25);
  opacity: 0; transition: opacity var(--dur-base) var(--ease-out);
}
@media (hover: hover) {
  .card:hover { transform: translateY(-3px); }
  .card:hover::after { opacity: 1; }
}

傾斜(僅用於展示項目,如產品、定價或信用卡;≤6°,僅 pointer,以 rAF 節流):

if (matchMedia('(hover: hover) and (prefers-reduced-motion: no-preference)').matches) {
  for (const el of document.querySelectorAll('.tilt')) {
    let raf = 0;
    el.addEventListener('pointermove', (e) => {
      cancelAnimationFrame(raf);
      raf = requestAnimationFrame(() => {
        const r = el.getBoundingClientRect(); // 每幀讀取一次,而非每次過渡
        const x = (e.clientX - r.left) / r.width - .5, y = (e.clientY - r.top) / r.height - .5;
        el.style.transform = `perspective(800px) rotateX(${-y * 6}deg) rotateY(${x * 6}deg)`;
      });
    });
    el.addEventListener('pointerleave', () => { cancelAnimationFrame(raf); el.style.transform = ''; });
  }
}

Toast / 徽章:跟隨動作 (5)

.toast { transition: transform var(--dur-slow) var(--ease-settle), opacity var(--dur-fast) var(--ease-out); }
.toast[data-state="closed"] { transform: translateY(12px); opacity: 0; transition-timing-function: var(--ease-in); }

超調僅用於到來的元素(Toast、徽章、計數器),絕不用於版面或文字區塊。

飛入購物車:弧線 (7)

將 X 和 Y 分給兩個巢狀元素,使用不同的緩動曲線;路徑會彎曲。

.fly-x { transition: transform 300ms linear; }
.fly-y { transition: transform 300ms var(--ease-in); }
.flying .fly-x { transform: translateX(var(--dx)); }
.flying .fly-y { transform: translateY(var(--dy)) scale(.4); }

在添加 .flying 之前,透過一次 getBoundingClientRect() 讀取來設定 --dx/--dy。

成功光環:次要動作 (8)

.btn.is-success::after {
  content: ""; position: absolute; inset: -4px; border-radius: inherit; border: 2px solid currentColor;
  animation: ring 400ms var(--ease-out) forwards; pointer-events: none;
}
@keyframes ring { from { opacity: .6; transform: scale(.95) } to { opacity: 0; transform: scale(1.15) } }

錯誤抖動:誇張的回饋 (10)

@keyframes shake { 20%,60% { transform: translateX(-4px) } 40%,80% { transform: translateX(4px) } }
.field[aria-invalid="true"] { animation: shake 280ms var(--ease-in-out); }

透過移除並重新添加屬性來重新觸發。務必搭配文字訊息(無障礙)。

等待狀態:多赫蒂門檻

立即給予按壓回饋;如果動作超過 400ms,在按鈕內部顯示旋轉器/進度條(保持其寬度固定以避免版面偏移)。偏好樂觀 UI:顯示結果,出錯時回滾。

雜亂輸入 → 乾淨輸出:波斯特爾定律

在 blur 時格式化(電話號碼、卡號、日期),而非每次按鍵時進行。以 150ms 的透明度變化來淡入/淡出數值,不做任何移動。

卷軸揭示:慢入慢出 (6) + 分塊 (米勒、希克)

內容預設可見;僅在 JS 確認可以揭示後才隱藏。

.js .reveal {
  opacity: 0; transform: translateY(var(--rise));
  transition: opacity var(--dur-slow) var(--ease-out), transform var(--dur-slow) var(--ease-out);
  transition-delay: calc(min(var(--i, 0), 5) * 50ms);
}
.js .reveal.in { opacity: 1; transform: none; }
document.documentElement.classList.add('js');
const io = new IntersectionObserver((entries) => {
  for (const e of entries) if (e.isIntersecting) { e.target.classList.add('in'); io.unobserve(e.target); }
}, { rootMargin: '0px 0px -10% 0px' });
document.querySelectorAll('.reveal').forEach((el) => io.observe(el));
  • 使用 style="--i: n" 進行交錯;上限為 6 步(米勒定律)。長列表作為一個群組揭示。
  • 僅揭示一次。跳過任何在視窗頂部以上的內容。
  • 框架:使用相同 CSS;在掛載的 effect 中執行觀察器,並在卸載時斷開連接。

覆蓋層:雅各布定律

僅使用慣例動畫:下拉選單從其觸發器展開(transform-origin 在觸發器側邊),模態框從中心淡入 + 縮放 0.98→1,面板從其邊緣滑入。優先使用原生元素:<dialog> / popover 搭配 @starting-style。

dialog, [popover] {
  opacity: 0; transform: translateY(4px) scale(.98);
  transition: opacity var(--dur-fast) var(--ease-in), transform var(--dur-fast) var(--ease-in),
              overlay var(--dur-fast) allow-discrete, display var(--dur-fast) allow-discrete;
}
dialog[open], [popover]:popover-open {
  opacity: 1; transform: none;
  transition-timing-function: var(--ease-out); transition-duration: var(--dur-base);
}
@starting-style {
  dialog[open], [popover]:popover-open { opacity: 0; transform: translateY(4px) scale(.98); }
}

每天透過鍵盤多次打開的命令面板/選單:使用頻率原則表示應跳過過渡效果。

頁籤:滑動的資料夾表面(非底線強調)

AI / 模板的標誌是細的強調底線,而非動畫本身。使用熟悉的物理形狀(雅各布定律)並讓該形狀負責移動:

  • 資料夾頁籤(首選):所選頁籤的表面合併到面板中,並滑動到點擊的頁籤。
  • 分段控制項:適用於 2–4 個選項;被按下的分段以同樣方式滑動。

讓頁籤等寬,這樣表面只需要 translateX(無需 width 或 scaleX,後者會扭曲圓角和邊框)。使用 ≤150ms 的過渡以保持可中斷性。內容立即切換(使用頻率原則)。

.tabs { position: relative; display: flex; gap: 2px; border-bottom: 1px solid var(--line); }
.tabs [role=tab] { position: relative; z-index: 1; flex: 0 0 96px; }
.tabs .surface { position: absolute; inset: auto 0 0; height: 2px; background: var(--accent); transition: transform var(--dur-fast) var(--ease-out); }
/* JS 設定 surface.style.transform = translateX(...) */

驗證

沒通過這些檢查,就沒有動畫。

  • 效能:在低階裝置(Moto G Power)上以 DevTools 效能面板錄製 60fps。是否有任何幀超過 16ms?是否有強制佈局(在「效能」標籤中尋找紅色三角形)?
  • 無障礙:prefers-reduced-motion: reduce 是否移除了所有移動效果?使用僅鍵盤導航是否仍可操作且邏輯順序正確?抖動是否搭配 aria-invalid 和文字說明?
  • 規則遵循:width、height 或 top 是否被動畫化?是否有任何 !important 覆蓋了減少動畫設定?可中斷的狀態是否使用 transition 而非 @keyframes?是否使用了 linear?
  • 感覺審查:有使用者說「動畫」嗎?如果有,說明太引人注意。有使用者說「流暢」嗎?如果是,就成功了。在同一個 250ms 區間內,是否有兩個東西在四處移動?
  • JS 失敗:關閉 JS。內容是否仍然可見且可互動?卷軸揭示器是否不會隱藏文字?
  • 可中斷性:快速數次點擊按鈕(或來回移動滑鼠)。過渡是否平順且不卡頓?按鈕是否在最後一次點擊時正確結束?

報告範本

## 精緻動畫報告

### 已套用 Token
- `--ease-out`、`--ease-in`、`--ease-settle` 及所有 `--dur-*` 變數已全域定義於 `:root`。
- `prefers-reduced-motion` 媒體查詢已到位。

### 接觸點
1. **按鈕按壓** (`src/components/Button.tsx:21-25`)
   - 原則:1(擠壓+拉伸)+ 費茲定律(44px 點擊區域)
   - `:hover` 下移 1px;`:active` 縮放至 0.97。
   - 觸發方式:點擊任何 `.btn`。

2. **錯誤抖動** (`src/components/Field.tsx:33-38`)
   - 原則:10(誇張回饋)
   - 在 `aria-invalid="true"` 時抖動 `280ms`。
   - 觸發方式:送出有驗證錯誤的表單。

3. **卡片懸浮** (`src/components/Card.vue:15-22`)
   - 原則:11(實體繪畫)
   - 升起 3px + 陰影;僅在 `(hover: hover)` 下啟用。
   - 觸發方式:在桌面版懸浮卡片。

### 驗證結果
- [x] 60fps:在 Moto G Power 上無掉幀。
- [x] 減少動畫:所有 translate 皆靜止;opacity 保留。
- [x] 無強制佈局。
- [x] 可中斷:點擊時快速懸浮按鈕可平順重定位。

相關技能