Communitygithub.com

antheo-motion

何かを動かすべきか判断し、正確なタイミング、イージング、距離を割り当てます(プレス、ホバー、メニュー、ダイアログ、シート、ドラッグ、ページ遷移)。動きの少ない処理にも対応。UIがぎこちない、静的すぎる、または過剰な動きがあると感じる時、ドロワーやドラッグの挙動がおかしい時、アニメーションをリリースする前に使用します。

antheo-motion とは?

Antheo Motionは、UIのアニメーションが単なる動きではなく、意味のある変化として機能することを保証するスキルです。これは、変更が発生するたびに、その頻度、目的、および適切な期間に基づいてアニメーション化するかどうかを決定するのに役立ちます。主な機能は、`antheo-tokens`からの定義済みの持続時間トークン(`--dur-instant`、`--dur-fast`、`--dur-base`など)と、到着時と退去時で一貫性のあるイージングカーブ(`--ease-out`)を提供することです。また、`prefers-reduced-motion`設定(アクセシビリティ対応)を処理し、`transform`や`opacity`などの安全なCSSプロパティの使用を強制して、パフォーマンスの問題(レイアウトシフトや`all`への遷移など)を回避します。このスキルには、ファイルされたフレームを通じてモーションを検証するための`filmstrip.mjs`スクリプトと、特定のパターン(プレス、ポップオーバー、シート、数値ロールなど)に関する詳細な参照資料が含まれています。主なルールは次のとおりです。頻繁に表示されるものはほとんど動かさない、キーボード操作は動かさない、終了は開始よりも速くする、すべての遷移は途中で中断可能である。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/antheo-design/skills/tree/HEAD/skills/antheo-motion

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

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

ドキュメント

Antheo Motion(モーション)

モーションとは変化に関する情報です。何かが到着したり、去ったり、移動したり、応答したりしたことを示します。何も説明しないモーションはノイズであり、モーションのない変化はジャンプです。このスキルは、どの変化を動かすかを決定し、それぞれに正確なタイミングを割り当てます。コンポーネントの特別な瞬間は antheo-moment に属し、持続時間トークンは antheo-tokens によって生成され、動きの抑制要件は antheo-access によってチェックされます。アプリ全体のモーションの監査、削減、または計画は antheo-motion-audit が担当します。

この順序で決定する

  1. 画面で発生するすべての変更をリストアップします:何が開く、閉じる、表示される、消える、並び替えられる、更新される、読み込まれる、成功する、失敗するか。
  2. ユーザーが目にする頻度をマークします:1日に何度も、毎日、またはまれに。
  3. 以下の表から、それぞれに持続時間とイージングを割り当てます。
  4. まれに発生する意味のあるイベントが1つあれば、それを antheo-moment に渡します。
  5. 素早く、2回、動きの抑制設定でチェックし、フィルムに撮ってフレームを読み取ります(以下参照)。

なぜ動くのか名前を付ける、さもなければ動かさない

「これは、ユーザーが___を理解するために動く。」 この文を完成できないなら、アニメーションはありません。

頻繁に見られるほど、動きは少なくなる

頻度得られるもの
1日に何度も(タイピング、行、タブ、メニュー、パレット)最大150ms、4pxの移動。キーボードからは、短いフェードのみ
毎日(ダイアログ、シート、トースト、保存)短い到着とより速い退出、150~300ms
まれに(初めての成功、注文の確定)特別な瞬間のための1つの場所(antheo-moment)

役割別の持続時間

トークン値用途
--dur-instant100ms色と不透明度のフィードバック
--dur-fast150msプレス、ホバーイン/アウト、メニューやツールチップの開閉
--dur-base200ms何かが去る、ダイアログが閉じる、値やテキストの入れ替え、トーストの到着
--dur-open250msダイアログのオープン、タブ、アコーディオン、カードのサイズ変更
--dur-slow300msシートやドロワーの上昇、マーカーのスライド移動
--dur-page400msページや共有要素の遷移

インターフェースのモーションは300ms以下に、ページ移動は400ms以下に抑えます。スピナー、プログレス、スクロール連動のモーションは linear で実行します。

開くと閉じるをペアで

もの開く閉じる
メニュー、ポップオーバー、セレクト150ms、トリガー位置から scale(0.97) とフェードで120ms
ツールチップ400msの遅延後、150msのフェード。別のツールチップが閉じてから300ms以内なら即時即時
ダイアログ250ms: 8px上昇、フェード、0.96からスケール200ms
シート、ドロワー300ms、端から。全体を通して完全不透明(フェードもブラーもなし)200ms
トースト200ms、12px上昇200ms、来た道を戻る
アコーディオン、高さの表示250ms、grid-template-rows: 0fr から 1fr へ200ms

閉じる操作やホバーアウトを遅延させてはいけません。代わりに持続時間を短くしてください。

到着と退出に1つのカーブ

--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、200ms未満のクロスフェードでは2pxのブラー。

アニメーションが許可されるもの

デフォルトでは transform と opacity(および色)。必要に応じて、短い filter ブラー、clip-path、高さの表示用の grid-template-rows。transition: all、width、height、top、left、margin、box-shadow 自体は絶対に使用しません。変化するシャドウは疑似要素に配置してフェードさせます。will-change はプロファイルで確認した後にのみ使用します。

トリガーから成長させる

メニューとポップオーバーは transform-origin をトリガーに設定します(Radix は --radix-popover-content-transform-origin を公開します)。モーダルは中央に配置。シートは存在する端から来ます。共有要素(カードがページに展開するようなもの)は、両側で1つの view-transition-name を使用します。

状態の遷移にはトランジション、1回限りにはキーフレーム

ユーザーがトグルできるものには、CSS トランジションまたはスプリングを使用します。これらは途中で逆転できます。キーフレームは1回だけ再生されるものにのみ使用します。

30~40msでスタガー、最初の8つまで、合計300ms

ヒーローの3~6つのパーツには60~80ms。頻繁に開くものをスタガーすることはなく、アイテムが到着している間にクリックをブロックすることもありません。

スプリングは手で動かすものだけに

スイッチのつまみ、解放されたドラッグ、滑らかなセグメントピル。コントロールではバウンスを0~0.2に(オーバーシュートはトラック内に収まる)、まれなお祝いでは最大0.45まで。揺れは最大1回まで。ドラッグは指にトランジションなしで追従し、解放時には解放速度からスプリングします。シートは、約0.11px/msより速いフリックで閉じるか、高さの min(64px, 15%) を移動した後に閉じます。そうでない場合は元の位置にスプリングバックします(references/gestures.md 参照)。

何もジャンプしない

変化するすべての値は、変化していることが確認できます。削除された行はその隙間を閉じます。表示されるもののためにスペースが確保されます(レイアウトシフト0.1未満)。読み込み時は、最大1つの入場。テーマの切り替えは、1フレームだけトランジションをオフにして行います。

動きの抑制:ストーリーはフェードで伝える

prefers-reduced-motion: reduce の下では、移動、スケール、ブラー、パララックス、バウンスは150~200msの不透明度クロスフェードになります。スイッチのつまみは即座に移動します。自動再生ループは停止します。5秒以上自動で動き続けるものには一時停止コントロールがあります(WCAG 2.2.2)。1秒間に3回以上点滅するものはありません(2.3.1)。

アプリ全体で

  1. 発見: すべての変更、その頻度、現在の動き、あるべき動きの表を作成します。
  2. 改善: すべての数値にトークンを使用、不足している終了処理、トリガー位置の原点、1つのパターンずつ。
  3. 削除: 毎回の読み込みでアニメーションするもの、1日に何度も発生するアクションで再生されるもの、次のアクションを遅延させるもの、ユーザーが読んでいる間にループするもの、または日常的なアクションで300msを超えるもの。迷ったら削除します。
  4. 承認または却下: 理由の文章、トークンのみ、許可されたプロパティのみ、入場よりも速い退出、動きの抑制対応、通常速度と4倍CPU slowdownで確認。

チェックする

すべてを高速で2回クリックします。逆転し、ジャンプしません。メニューを20回開きます:それでも高速です。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クロック)にスローダウンし、1つのアクションを実行し、要素の12フレームを1枚のシートに、それぞれの時間とともに配置します。シートを開いて各フレームを読み取ります。

  • 各フレームはそれ自体で構成されているように見える:ハードエッジがスライドして通過しない、間違った色がフラッシュしない、空のボックスがない
  • 変化するすべての値は変化していることが確認できる:ロールすべき数字が、その針がまだ移動している間にスナップしない
  • 途中でリフローやジャンプが発生しない。最初のフレームはすでにプレスの応答を示している
  • 終了位置は適切に収まる:スプリングは少しオーバーシュートして戻ってくる、コントロールは突然停止しない
  • --reduce と --dark を付けて再度フィルムを撮る:ストーリーは依然として語られており、ダークモードで光のフラッシュがない

フレームに表示された問題を修正し、再度フィルムを撮り、最後のシートを証拠として保存します。

生成UIがここで間違えること

完了と判断する前に、references/habits.md の各項目を確認してください:transition: all · スクリプトが表示するまでコンテンツが非表示 · 包括的な動きの抑制リセット · フェードインまたはスライドインするフォーカスリング · パフォーマンスを発揮するモーション · クリックできないものへのホバーエフェクト · 誰も定義していない名前を読み取るトランジション。

より多くのモーションが適切な場合

目的と頻度のルールが決定します。数値はデフォルトです。ゲーム、クリエイティブツール、学習製品、またはユーザーが要求したブランドの瞬間は、より多く、より長く動く場合があります。それでも、入力に即座に応答し、次のアクションをブロックせず、途中で中断でき、動きの抑制を尊重し、そのコストを示す必要があります。ミッドレンジの電話での遅いフレームは、スタイルに関係なく発見事項です。

完了条件

  • すべての変更が頻度とともにリストアップされている。頻繁なものはほとんど動かない。キーボード操作は移動しない
  • 持続時間とイージングはトークンから取得。上記の開閉ペア。閉じるの遅延なし
  • 許可されたプロパティのみ。原点はトリガー位置。scale(0) からは開始しない
  • 動きの抑制はクロスフェードになる。5秒を超えるループは一時停止可能
  • 高速で2回クリック、4倍スローダウン、動きの抑制ありで確認済み
  • 各モーションをフィルムに撮り(scripts/filmstrip.mjs)、すべてのフレームを読み取り、ライト、ダーク、動きの抑制の各モードで確認済み
  • references/habits.md のすべての習慣に対してチェック済み

ファイル

  • scripts/filmstrip.mjs:1つのモーションを0.1倍で撮影し、各フレームの下に時間が記載されたフレームシートを作成します
  • references/recipes.md:プレスやポップオーバーから、数値ロールやストリーミングテキストまで、コピー可能な36のレシピのインデックス。各ファイルは references/recipes/ にあります
  • references/why.md:すべてのルールの背後にある理由。値が恣意的に見えたり、誰かがそれを破りたいと思ったときのために
  • references/gestures.md:ドラッグ、スワイプ、シート、スナップポイント、モメンタム、ラバーバンディング(電話の感触:antheo-mobile)
  • references/choreography.md:複数のものを1つの変化として扱う:ギャップを閉じる、並び替え、パネルのリサイズ、クロスフェード
  • references/springs.md:平易な言葉でのスプリング、プリセット、30行のJSスプリング、フォールバック付き linear()
  • references/performance.md:アニメーションに安価なもの、安価な電話で60fps、プロファイリング方法
  • references/advanced.md:3D、スクロール駆動アニメーション、ビュートランジション、モーションのフィルミング
  • references/vocabulary.md:平易な説明からパターン名、レシピへ
  • references/motion-kit.css:生成された motion.css のフォールバックコピー
  • references/habits.md:生成UIがここで間違えることと、それぞれの修正方法

関連スキル