Communitygithub.com

TheMystic07/OpenWalc

モーションデザインとUIアニメーション。マイクロインタラクション、ページトランジション、ローディング状態など、ウェブおよびモバイルプラットフォーム向けのUIアニメーションを作成する際に使用します。

OpenWalc とは?

このスキルは、UIアニメーションとモーションデザインに関する包括的なガイドです。アニメーションの12原則をUIに適用する方法から、タイミング、イージング関数、パフォーマンス最適化、アクセシビリティまでを網羅しています。CSSアニメーション、Framer Motion、GSAP、Web Animations APIなど、さまざまな実装手法を比較しながら、実践的なコード例とともに解説します。マイクロインタラクションやページトランジション、リストアニメーションなどの具体的なパターンも提供しており、ReactやVueなどの主要なフレームワークと連携して使用できます。また、`prefers-reduced-motion`メディアクエリやWCAGガイドラインに準拠したアクセシブルなアニメーション設計についても詳しく説明しています。デベロッパーやデザイナーが、パフォーマンスとユーザビリティを両立した意図的なアニメーションを作成できるように設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TheMystic07/OpenWalc/tree/HEAD/.agent/skills/ui-animation

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

UIアニメーション&モーションデザイン

ユーザーインターフェースにおいて、目的を持ち、パフォーマンスの高いアニメーションを作成するための包括的なガイドです。

アニメーションの原則

アニメーションの12原則(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

計算式:
持続時間 = ベース時間 + (距離 × 係数)

イージング関数

標準的なイージング

リニア(線形)
├────────────────────────────┤
一定の速度。自然な動きは稀。
使用: プログレスバー、時計の針

EASE-OUT(減速)
├═══════════────────────────┤
高速開始、低速終了。
使用: 画面に入る要素

EASE-IN(加速)
├────────────────═══════════┤
低速開始、高速終了。
使用: 画面から出る要素

EASE-IN-OUT(S字カーブ)
├────═══════════════────────┤
低速開始と終了、中間が高速。
使用: 画面上のトランジション

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回転あたり1〜2秒
- イージング: リニア(一定の動き)
- スタイル: ブランドアイデンティティに合わせる

ページトランジション

クロスフェード:
├──────────────────────────────────────────┤
│ 古いページ: opacity 1 → 0, 200ms           │
│ 新しいページ: opacity 0 → 1, 200ms           │
│ タイミング: 順次またはオーバーラップ        │
└──────────────────────────────────────────┘

スライド:
├──────────────────────────────────────────┤
│ 方向はナビゲーション階層に従う   │
│ 進む: 左にスライド(新要素は右から)     │
│ 戻る: 右にスライド(前要素は左から)       │
│ 持続時間: 300-400ms                      │
└──────────────────────────────────────────┘

共有要素:
├──────────────────────────────────────────┤
│ 要素が状態間で変形            │
│ 位置、サイズ、border-radiusが変化     │
│ 画面間の連続性を生み出す       │
│ 持続時間: 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テクニック

// First: 初期位置を取得
const first = element.getBoundingClientRect();

// Last: 変更を適用し、最終位置を取得
const element.classList.add("moved");
const last = element.getBoundingClientRect();

// Invert: 差分を計算し、逆変換を適用
const deltaX = first.left - last.left;
const deltaY = first.top - last.top;
element.style.transform = `translate(${deltaX}px, ${deltaY}px)`;

// Play: トランジションで変換を解除
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" }}
>
  Content
</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 {
    /* 動きをopacityに置き換え */
    animation: none;
    transition: opacity 200ms ease;
  }
}

安全なアニメーションの実践

前庭障害のあるユーザーには避ける:
✗ パララックススクロール効果
✗ ズーム/スケールアニメーション
✗ 回転する要素
✗ 自動再生アニメーション
✗ フラッシュ(3回/秒以上)

安全な代替案:
✓ 不透明度のフェード
✓ 色のトランジション
✓ 微妙な位置の変化
✓ ユーザーが開始するアニメーション

WCAGガイドライン

2.2.2 一時停止、停止、非表示:
- 自動更新コンテンツは一時停止可能であること
- 読書に時間制限がないこと

2.3.1 3回のフラッシュ:
- 毎秒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モーション、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.

関連スキル