Communitygithub.com

TheMystic07/OpenWalc

動態設計與使用者介面動畫。適用於建立微互動、頁面轉場、載入狀態或任何網頁與行動平台上的 UI 動畫。

OpenWalc 是什麼?

這是一個全面的 UI 動畫與動態設計指南,專為開發者與設計師打造,旨在建立有目的且高效能的動畫。此技能涵蓋從動畫原則(如時間調整、緩動函數和 12 個基本動畫原理)到實作細節的一切內容,包含 CSS 動畫、JavaScript 函式庫(如 Framer Motion 和 GSAP)以及 FLIP 技術。它強調動畫應服務於功能性目的(如引導注意力、提供反饋和減少認知負擔),而非純粹的裝飾。該指南還深入探討了關鍵的效能最佳化策略,例如使用 GPU 加速的屬性(transform 和 opacity)並避免觸發版面配置的屬性。此外,它還着重於無障礙性,指導使用者如何透過 `prefers-reduced-motion` 應對前庭障礙,並提供行動平台的最佳實踐,包括平台慣例(iOS、Android、Web)和觸控反饋。通過使用動畫代幣(duration、easing)整合設計系統,並提出實用的「應做」與「不應做」建議,總結出開發人員需要的一切,以建立流暢、可存取且品牌一致的 UI 動畫。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TheMystic07/OpenWalc/tree/HEAD/.agent/skills/ui-animation

在你喜歡的 AI 中提問

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

說明文件

UI 動畫與動態設計

建立有目的且高效能的使用者介面動畫的完整指南。

動畫原則

動畫十二原則(應用於 UI)

原則UI 應用情境
時間調整持續時間反映重要性/距離
緩動函數自然的加速/減速
預期動作動作前的視覺準備
跟隨動作停止後動量的延續
次要動作支援元素做出的回應
佈局安排將注意力吸引到關鍵元素
擠壓與拉伸有彈性、俏皮的互動
誇張手法強調重要的反饋
弧線運動自然的曲線運動路徑
重疊動作元素以不同速率移動
立體繪圖保持一致的 3D 空間
吸引力引人入勝、令人愉悅的動作

為何要使用動畫?

功能目的:
✓ 引導注意力至重要的變化
✓ 顯示元素之間的關係
✓ 為動作提供反饋
✓ 溝通系統狀態
✓ 減輕認知負擔
✓ 建立空間方向感

不適合作為:
✗ 純粹的裝飾
✗ 炫技
✗ 讓東西「感覺現代」
✗ 干擾內容

時間與持續時間

持續時間指南

即時 (0-100ms):
└─→ 按鈕狀態變化
└─→ 切換開關
└─→ 微反饋

快速 (100-200ms):
└─→ 懸停效果
└─→ 簡單淡入淡出
└─→ 小幅移動

標準 (200-300ms):
└─→ 大部分 UI 轉場
└─→ 模態框開啟/關閉
└─→ 下拉式選單

緩慢 (300-500ms):
└─→ 複雜轉場
└─→ 頁面轉場
└─→ 大型元素移動

刻意的 (500ms+):
└─→ 英雄動畫
└─→ 骨架載入
└─→ 引導流程

基於距離的時間

規則:距離越長 = 持續時間越長

小 (< 100px):   150-200ms
中 (100-300px): 200-300ms
大 (300-500px): 300-400ms
全螢幕:         400-500ms

公式:
duration = baseTime + (distance × factor)

緩動函數

標準緩動函數

線性 (LINEAR)
├────────────────────────────┤
恆定速度。很少自然。
用途:進度條、時鐘指針

減速 (EASE-OUT)
├═══════════────────────────┤
快速開始,緩慢結束。
用途:元素進入螢幕

加速 (EASE-IN)
├────────────────═══════════┤
緩慢開始,快速結束。
用途:元素離開螢幕

加減速 (EASE-IN-OUT)
├────═══════════════────────┤
緩慢開始和結束,中間快速。
用途:螢幕上轉場

超越回彈 (EASE-OUT-BACK)
├═══════════────────────╗───┤
超越目標,然後回彈歸位。
用途:俏皮的進入、彈跳效果

CSS 緩動值

/* 內建關鍵字 */
linear: cubic-bezier(0, 0, 1, 1)
ease: cubic-bezier(0.25, 0.1, 0.25, 1)
ease-in: cubic-bezier(0.42, 0, 1, 1)
ease-out: cubic-bezier(0, 0, 0.58, 1)
ease-in-out: cubic-bezier(0.42, 0, 0.58, 1)

/* Material Design 標準 */
standard: cubic-bezier(0.4, 0, 0.2, 1)
decelerate: cubic-bezier(0, 0, 0.2, 1)
accelerate: cubic-bezier(0.4, 0, 1, 1)

/* 自訂:乾脆 */
snappy: cubic-bezier(0.5, 0, 0, 1)

/* 自訂:彈跳 */
bouncy: cubic-bezier(0.68, -0.55, 0.27, 1.55)

/* 彈簧效果 (使用 JS 函式庫) */
spring: { stiffness: 300, damping: 20 }

何時使用哪一種

情境緩動函數原因
元素進入ease-out精力充沛地到達,然後安定下來
元素離開ease-in積聚動量以離開
螢幕上的變化ease-in-out平滑的狀態變化
吸引注意力bounce/spring俏皮、引人注目
背景/細微ease-out不引人注目

動畫模式

微互動

按鈕狀態:
┌─────────────────────────────────────────┐
│ 靜止 → 懸停:scale(1.02), 100ms        │
│ 懸停 → 啟用:scale(0.98), 50ms        │
│ 啟用 → 靜止:scale(1), 150ms ease-out │
└─────────────────────────────────────────┘

切換開關:
┌─────────────────────────────────────────┐
│ 滑塊:translateX, 200ms ease-out       │
│ 軌道:background-color, 200ms          │
│ 狀態:結尾輕微回彈                      │
└─────────────────────────────────────────┘

核取方塊:
┌─────────────────────────────────────────┐
│ 勾選記號:stroke-dashoffset 動畫       │
│ 背景:從中心縮放, 150ms                 │
│ 漣漪效果:擴張圓形, 300ms               │
└─────────────────────────────────────────┘

載入狀態

骨架畫面:
┌──────────────────────────┐
│ ▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░░░  │ 閃爍效果
│ ▓▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░  │ 線性漸層
│ ▓▓▓▓▓▓░░░░░░░░░░░░░░░░  │ 從左到右移動
└──────────────────────────┘

CSS:
background: linear-gradient(
  90deg,
  #f0f0f0 25%,
  #e0e0e0 50%,
  #f0f0f0 75%
);
background-size: 200% 100%;
animation: shimmer 1.5s infinite;

旋轉圖示:
- 持續時間:每次旋轉 1-2 秒
- 緩動:linear (一致的運動)
- 風格:符合品牌識別

頁面轉場

交叉淡入淡出:
├──────────────────────────────────────────┤
│ 舊頁面:opacity 1 → 0, 200ms          │
│ 新頁面:opacity 0 → 1, 200ms          │
│ 時間:順序或重疊                        │
└──────────────────────────────────────────┘

滑入:
├──────────────────────────────────────────┤
│ 方向跟隨導覽層級                        │
│ 前進:向左滑 (新從右來)                  │
│ 後退:向右滑 (前從左來)                  │
│ 持續時間:300-400ms                      │
└──────────────────────────────────────────┘

共享元素:
├──────────────────────────────────────────┤
│ 元素在狀態間變形                        │
│ 位置、大小、邊框半徑改變                │
│ 在畫面之間建立連續性                    │
│ 持續時間:300-500ms                      │
└──────────────────────────────────────────┘

列表動畫

交錯進入:
┌─ 項目 1 ────────────────┐  延遲: 0ms
├─ 項目 2 ────────────────┤  延遲: 50ms
├─ 項目 3 ────────────────┤  延遲: 100ms
├─ 項目 4 ────────────────┤  延遲: 150ms
└─ 項目 5 ────────────────┘  延遲: 200ms

最大總持續時間:500ms
交錯延遲:每項 30-50ms
動畫:translateY + opacity

重新排序:
- 使用 FLIP 技術
- 持續時間:200-300ms
- 緩動:ease-out

效能

GPU 加速屬性

快速 (僅合成器):
✓ transform: translate, scale, rotate
✓ opacity
✓ filter (搭配 will-change)

緩慢 (觸發佈局/繪製):
✗ width, height
✗ margin, padding
✗ top, left, right, bottom
✗ border, border-radius
✗ font-size
✗ box-shadow (重繪)

最佳化:
will-change: transform, opacity;
/* 節制使用! */

效能指南

/* 良好:GPU 加速 */
.animated-element {
  transform: translateX(0);
  transition: transform 300ms ease-out;
}
.animated-element.moved {
  transform: translateX(100px);
}

/* 不良:觸發佈局 */
.animated-element {
  left: 0;
  transition: left 300ms ease-out;
}
.animated-element.moved {
  left: 100px;
}

FLIP 技術

// 第一步:取得初始位置
const first = element.getBoundingClientRect();

// 第二步:套用變更,取得最終位置
element.classList.add("moved");
const last = element.getBoundingClientRect();

// 反轉:計算差異,套用反向變換
const deltaX = first.left - last.left;
const deltaY = first.top - last.top;
element.style.transform = `translate(${deltaX}px, ${deltaY}px)`;

// 播放:透過轉場移除變換
requestAnimationFrame(() => {
  element.style.transition = "transform 300ms ease-out";
  element.style.transform = "";
});

CSS 動畫技術

關鍵影格動畫

@keyframes fadeSlideIn {
  from {
    opacity: 0;
    transform: translateY(20px);
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

.element {
  animation: fadeSlideIn 300ms ease-out forwards;
}

/* 搭配步驟 */
@keyframes typewriter {
  from {
    width: 0;
  }
  to {
    width: 100%;
  }
}

.typing-text {
  animation: typewriter 2s steps(20) forwards;
}

轉場

.button {
  background: var(--primary);
  transform: scale(1);
  transition:
    background 150ms ease-out,
    transform 100ms ease-out;
}

.button:hover {
  background: var(--primary-hover);
  transform: scale(1.02);
}

.button:active {
  transform: scale(0.98);
  transition-duration: 50ms;
}

動畫縮寫

/* animation: 名稱 持續時間 緩動函數 延遲
              執行次數 方向 填滿模式 播放狀態 */

animation: slideIn 300ms ease-out 100ms 1 normal forwards running;

/* 常用模式 */
animation: spin 1s linear infinite;
animation: pulse 2s ease-in-out infinite alternate;
animation: fadeIn 300ms ease-out forwards;

JavaScript 動畫函式庫

比較

函式庫最佳用途套件大小
CSS簡單轉場0kb
Web Animations API原生、高效能0kb
GSAP複雜、精確~60kb
Framer MotionReact 生態系~50kb
anime.js時間軸、SVG~17kb
Motion One現代、輕量~18kb
LottieAfter Effects 匯出~50kb

Framer Motion (React)

import { motion, AnimatePresence } from "framer-motion";

// 基本動畫
<motion.div
  initial={{ opacity: 0, y: 20 }}
  animate={{ opacity: 1, y: 0 }}
  exit={{ opacity: 0, y: -20 }}
  transition={{ duration: 0.3, ease: "easeOut" }}
>
  內容
</motion.div>;

// 用於複雜動畫的變體
const containerVariants = {
  hidden: { opacity: 0 },
  visible: {
    opacity: 1,
    transition: {
      staggerChildren: 0.1,
    },
  },
};

const itemVariants = {
  hidden: { opacity: 0, y: 20 },
  visible: { opacity: 1, y: 0 },
};

<motion.ul variants={containerVariants} initial="hidden" animate="visible">
  {items.map((item) => (
    <motion.li key={item.id} variants={itemVariants}>
      {item.name}
    </motion.li>
  ))}
</motion.ul>;

GSAP

import { gsap } from "gsap";

// 基本補間
gsap.to(".element", {
  x: 100,
  opacity: 1,
  duration: 0.3,
  ease: "power2.out",
});

// 時間軸
const tl = gsap.timeline();
tl.from(".header", { y: -100, duration: 0.5 })
  .from(".content", { opacity: 0, duration: 0.3 }, "-=0.2")
  .from(".button", { scale: 0.8, duration: 0.2 });

// ScrollTrigger
gsap.registerPlugin(ScrollTrigger);
gsap.to(".parallax", {
  y: -100,
  scrollTrigger: {
    trigger: ".section",
    start: "top center",
    end: "bottom center",
    scrub: true,
  },
});

無障礙性

尊重使用者偏好

/* 為偏好減少動畫的使用者 */
@media (prefers-reduced-motion: reduce) {
  *,
  *::before,
  *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}

/* 或提供更簡單的替代方案 */
@media (prefers-reduced-motion: reduce) {
  .animated-element {
    /* 用透明度取代動畫 */
    animation: none;
    transition: opacity 200ms ease;
  }
}

安全的動畫實踐

避免用於前庭障礙者:
✗ 視差滾動效果
✗ 縮放/縮放動畫
✗ 旋轉/轉動元素
✗ 自動播放動畫
✗ 閃爍 (超過 3 次/秒)

安全的替代方案:
✓ 透明度淡入淡出
✓ 顏色轉場
✓ 微小的位置變化
✓ 使用者啟動的動畫

WCAG 指南

2.2.2 暫停、停止、隱藏:
- 自動更新內容可以暫停
- 閱讀沒有時間限制

2.3.1 三次閃爍:
- 任何閃爍不得超過每秒 3 次

2.3.3 來自互動的動畫:
- 運動可以被停用
- 觸發動畫時應尊重偏好

行動裝置考量

觸碰反饋

/* iOS 風格的點擊反饋 */
.button {
  -webkit-tap-highlight-color: transparent;
  touch-action: manipulation;
}

.button:active {
  opacity: 0.7;
  transition: opacity 50ms;
}

/* 漣漪效果 */
.ripple {
  position: relative;
  overflow: hidden;
}

.ripple::after {
  content: "";
  position: absolute;
  background: rgba(255, 255, 255, 0.3);
  border-radius: 50%;
  transform: scale(0);
  animation: ripple 400ms ease-out;
}

平台慣例

平台動畫風格
iOS彈簧物理,300-500ms,細微
AndroidMaterial Motion,200-300ms,強調
Web多變,通常 200-400ms

設計系統整合

動畫代幣

:root {
  /* 持續時間 */
  --duration-instant: 100ms;
  --duration-fast: 150ms;
  --duration-normal: 250ms;
  --duration-slow: 400ms;
  --duration-slower: 600ms;

  /* 緩動函數 */
  --ease-default: cubic-bezier(0.4, 0, 0.2, 1);
  --ease-in: cubic-bezier(0.4, 0, 1, 1);
  --ease-out: cubic-bezier(0, 0, 0.2, 1);
  --ease-bounce: cubic-bezier(0.68, -0.55, 0.27, 1.55);

  /* 組合 */
  --transition-default: var(--duration-normal) var(--ease-default);
  --transition-fast: var(--duration-fast) var(--ease-out);
}

/* 用法 */
.element {
  transition: transform var(--transition-default);
}

最佳實踐

應該這麼做:

  • 以目的驅動動畫 (反饋、引導)
  • 使用 GPU 加速的屬性
  • 將持續時間保持在 500ms 以下
  • 讓動畫符合品牌個性
  • 尊重 prefers-reduced-motion
  • 在低階裝置上測試
  • 使用一致的計時系統

不應該這麼做:

  • 只為了裝飾而動畫
  • 阻擋使用者互動
  • 過度使用彈跳/超越效果
  • 引發暈動症
  • 忘記退出動畫
  • 忽略效能指標

…

[為翻譯而截斷]

Individual skills in this repo

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

相關技能