Communitygithub.com

subtle-motion

あらゆるWebサイト(プレーンHTML/CSS、React、Next、Vue、Svelte、Astro)に、控えめで洗練されたアニメーションを追加し、サイトの感触を向上させます。「アニメーションしている」と感じさせず、スムーズで応答性が高く、低スペックなスマートフォンでも60fpsを維持します。

subtle-motion とは?

このスキル「subtle-motion」は、Webサイトに「味付け」としての微細なモーションを追加するための包括的なガイドラインと実装パターンを提供します。ディズニーの12のアニメーション原則をUIに適用し、フィッツの法則、ヒックの法則、ミラーの法則、ドハティのしきい値、ポステルの法則、ヤコブの法則、使用頻度の法則といった、モーションに関連するUXの法則を組み合わせています。主な特徴として、`transform`と`opacity`のみをアニメーション化し、パフォーマンスを最適化すること、スナッピーなタイミング(UIモーションは300ms未満)、小さな距離、イーズイン/イーズアウト、使用頻度に応じたアニメーション制御(頻繁に使うものほどアニメーションを控える)、ドハティしきい値(100ms以内に応答、400ms以内に完了)、`prefers-reduced-motion`への対応、CSS優先、アニメーションの割り込み可能性などが含まれます。このスキルは、ユーザーが `/subtle-motion` と入力した場合や、「サイトの感触を良くして」「滑らかにして」「マイクロインタラクションを追加して」「スクロールリビール」「ホバーエフェクト」などを依頼した場合に使用します。対応フレームワークは、プレーンHTML/CSS、React、Next、Vue、Svelte、Astroです。

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

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

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

ドキュメント

Subtle Motion(控えめなモーション)

モーションは味付けです。ユーザーはサイトが「滑らか」だと感じるべきであり、「アニメーション」に気づくべきではありません。 出典:ディズニー『The Illusion of Life』、Jon Yablonski著『Laws of 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(一定速度)は使わないこと。表示(出現)にはイーズアウト、非表示(消失)にはイーズインを使用します。
  5. 使用頻度:使用頻度が高いほど、アニメーションは控えめにする。 キーボードナビゲーション、コマンドパレット、1日に100回使うタブ、リスト選択:瞬時(0ms)または≤100msのフェード。初回や稀な瞬間にはアニメーションを適用し、繰り返し行う操作には適用しません。
  6. ドハティしきい値:100ms以内に応答し、400ms以内に完了する。 フィードバック(押下状態、保留状態)は、入力と同じフレームで開始します。400msより遅い場合は、進捗状況を表示します。
  7. prefers-reduced-motion: reduceは動きを無効にする。 不透明度のフェードは残しても構いません。
  8. ホバーエフェクトは@media (hover: hover)の下でのみ使用する。 タッチデバイスでは、そうしないと粘着性ホバー(sticky hovers)になります。
  9. CSSを優先し、アニメーションライブラリは使わない。 ただし、プロジェクトですでに使用している場合は除きます。CSSで実現できる処理にJSループは使いません。
  10. コンテンツを遅延させたり隠したりしない。 リビール(表示)は、JSが失敗した場合でもコンテンツを隠してはいけません。クリックをブロックしたり、LCP要素を読み込み時にアニメーション化したりしてはいけません。
  11. ステージング:一度に一つの焦点モーション。 ページあたり最大約5つのモーションポイントまで。同じ瞬間に、目を引き合うものを二つ配置してはいけません。
  12. will-changeはアニメーション中のみ使用する(または≤3つの永続的な要素に対して)。
  13. デフォルトで割り込み可能にする。 途中で状態が反転する可能性があるもの(ホバー、トグル、開閉、タブインジケーター)は、transitionを使用します。これは現在の位置から再ターゲットされます。@keyframesは、クリーンに再起動する一度きりの瞬間(シェイク、リング、送信)にのみ使用します。
  14. サイズと開始要因に応じて持続時間を調整する。 小さな要素は大きな要素より速く(アイコン100ms、カード250ms、シート300ms)。ユーザー開始=即座に、システム開始(トースト、バックグラウンド更新)=遅めでも可。
  15. 3回/秒以上の点滅は禁止。ループが5秒を超えるものには、一時停止コントロールが必要(またはループさせないこと)。

原則をUIルールに適用

タッチポイントに合ったものを選んでください。一度にすべてを使わないでください。それぞれが以下のパターンに対応します。

#原則UIでの意味パターン
1スクワッシュ&ストレッチ(Squash & stretch)物は衝撃で潰れ、動きで伸びる:重量感押下(Press)、トグル(Toggle)
2予備動作(Anticipation)大きな動き(送信、投稿、フライアウト)の前に小さな引き戻し送信ボタン(Send button)
3ステージング(Staging)視線を一点に誘導する:兄弟要素を暗くし、一度に一つの動きカードフォーカス(Card focus)
4ポーズ・トゥ・ポーズ(Pose to pose)開始/終了状態を定義し、ブラウザにトゥイーンを任せるtransition、フレーム単位のJSではない
5フォロースルー(Follow through)本体が止まった後にパーツが収束する(小さな行き過ぎ)トースト(Toast)、バッジ(Badge)
6スローイン&スローアウト(Slow in & slow out)加速と減速、一定速度は避けるトークン(Tokens)
7弧(Arcs)移動する要素は直線ではなく曲線に沿って動くカートに飛ばす(Fly-to-cart)
8セカンダリーアクション(Secondary action)メインのアクションを補完する小さな演出成功リング(Success ring)
9スナッピータイミング(Snappy timing)持続時間が感触を決める。UIは300ms未満トークン(Tokens)
10誇張されたフィードバック(Exaggerated feedback)現実を超えて押し込むことで瞬間を印象付ける(エラー、成功)エラーシェイク(Error shake)
11ソリッドドローイング/3D(Solid drawing / 3D)平面的なものに奥行きとボリュームを与えるチルトカード(Tilt card)
12アピール(Appeal)すべての細部の合計、サイト全体で一貫していること検証パス(Verify pass)
UXの法則モーションへの影響パターン
フィッツの法則(Fitts's law)大きくて近いターゲットほどクリックしやすいヒットエリア(Hit areas)
ヒットエリアを大きくする(Bigger hit areas)クリック可能領域は44×44px以上、視覚的なサイズが小さくてもヒットエリア(Hit areas)
ヒックの法則(Hick's law)選択肢が多いほど判断が遅くなる。多くの選択肢を一度にアニメーション化しないスタッガー制限(Stagger cap)
ミラーの法則(Miller's law)コンテンツをチャンク化(約7項目)。アイテムごとではなくグループで表示スタッガー制限(Stagger cap)
ドハティしきい値(Doherty threshold)100ms未満のフィードバック、400ms未満の合計時間、それ以上は進捗表示保留状態(Pending state)
ポステルの法則(Postel's law)乱雑な入力を受け入れ、クリーンな出力を返す。クリーンアップを穏やかにアニメーション化入力フォーマット(Input format)
ヤコブの法則(Jakob's law)慣習的なモーションを使う(メニューはトリガーからドロップダウン、モーダルは中央からフェード&スケール)オーバーレイ(Overlay)
使用頻度(Frequency of use)頻繁に使うものほどアニメーションは控えめにルール5

ワークフロー

  1. まずサイトを読む。 フレームワーク、CSSアプローチ(Tailwind、CSS Modules、プレーン)、既存のモーションとトークン。それらを再利用する。
  2. 各インタラクティブ要素を使用頻度で分類する: 稀(サインアップ、チェックアウト、成功)、時々(カード、セクション、モーダル)、頻繁(ナビゲーション、タブ、パレット、リスト行)。頻繁に使うものは≤100msまたはなし。
  3. 最大5つのタッチポイントを選び、感触対コストで優先順位付けする:
    1. ボタン/リンク:押下時のスクワッシュ+ヒットエリア(原則1、フィッツ)
    2. フォームフィードバック:エラーシェイク、成功リング、保留状態(10、8、ドハティ)
    3. カード:ホバーでの浮き上がり、オプションでチルト(11)
    4. セクション:スクロールリビール、チャンク化されたスタッガー(6、ミラー)
    5. オーバーレイ/トースト:フォロースルーを伴う表示/非表示(5、ヤコブ)
  4. トークンを一度だけ、グローバルに追加する。
  5. 選択したタッチポイントにのみパターンを適用する。
  6. 検証する(最後のセクション)。検証が終わるまで完了しない。
  7. 報告する: 各タッチポイントについて、ファイル:行、適用した原則、確認方法を記載する。

トークン(一度だけ、グローバルに追加)

: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プロジェクトの場合?新しいCSSファイルの代わりに、これらを@theme / tailwind.configのextendに配置する。

パターン

押下(Press):スクワッシュ(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%; }

トグル(Toggle):スクワッシュ&ストレッチ(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; }

送信/投稿(Send / submit):予備動作(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; }

カードフォーカス(Card focus):ステージング(3)

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

1つの選択が重要な密集グリッドにのみ使用。人が読むコンテンツではスキップする。

カードリフト+オプションのチルト(Card lift + optional tilt):ソリッドドローイング(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°以下、ポインターのみ、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(); // フレームごとに1回読み取る、トランジションごとではない
        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 / badge):フォロースルー(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); }

行き過ぎは、到着するもの(トースト、バッジ、カウンター)にのみ適用。レイアウトやテキストブロックには適用しない。

カートに飛ばす(Fly-to-cart):弧(7)

XとYを2つのネストされた要素に分割し、それぞれに異なるイージングを適用すると、経路が曲線になる。

.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を追加する前に、1回のgetBoundingClientRect()の読み取りで--dx/--dyを設定する。

成功リング(Success ring):セカンダリーアクション(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) } }

エラーシェイク(Error shake):誇張されたフィードバック(10)

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

属性を削除して再度追加することで、再トリガーする。常にテキストメッセージと組み合わせる(アクセシビリティ)。

保留状態(Pending state):ドハティしきい値

押下フィードバックは即座に行う。アクションが400ms以上かかる場合は、ボタン内にスピナー/プログレスを表示する(レイアウトシフトを避けるため幅は固定)。楽観的UIを優先する:結果を表示し、エラー時にロールバックする。

乱雑な入力→クリーンな出力:ポステルの法則

すべてのキーストロークではなく、blur時にフォーマットする(電話番号、カード番号、日付)。150msの不透明度変更で値をクロスフェードし、移動は行わない。

スクロールリビール(Scroll reveal):スローイン/アウト(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ステップに制限(ミラー)。長いリストは1つのグループとしてリビールする。
  • リビールは一度だけ。スクロールせずに見える部分(above the fold)はスキップする。
  • フレームワーク:同じCSS。マウントエフェクトでオブザーバーを実行し、アンマウント時に切断する。

オーバーレイ:ヤコブの法則

慣習的なモーションのみ:ドロップダウンはトリガーから拡大する(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); }
}

1日に何度もキーボードで開くコマンドパレット/メニュー:使用頻度の法則により、トランジションはスキップする。

タブ:スライドするフォルダ面(下線アクセントではない)

AI/テンプレートの特徴は細いアクセント下線であり、モーションではない。おなじみの物理的な形状(ヤコブ)を使用し、その形状を動かす:

  • フォルダタブ(推奨):選択されたタブの面がパネルに溶け込み、クリックされたタブまでスライドする。
  • セグメントコントロール:2~4のオプションの場合。押し込まれたセグメントが同じようにスライドする。

面がtranslateXのみを必要とするように、タブを等幅にする(幅や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; /* 例:等幅 */ background: transparent; border: 0; cursor: pointer; }
.tabs .indicator {
  position: absolute; bottom: 0; left: 0; height: 100%; width: 96px; /* タブの幅と一致させる */
  background: var(--surface-raised); border-radius: 8px 8px 0 0;
  transition: transform 150ms var(--ease-out);
}
.tabs[data-active="0"] .indicator { transform: translateX(0); }
.tabs[data-active="1"] .indicator { transform: translateX(98px); } /* gap分 */
.tabs[data-active="2"] .indicator { transform: translateX(196px); }

関連スキル