アニメーション用語集
このリポジトリ(Asymmetric-al/core)
このリポジトリ所有のオーバーレイは、アップストリームの用語集をCoreの正規フロントエンドガイダンスと互換性のある範囲に狭く保ちます。アップストリームが更新された後は、bun run skills:sync を実行する前に調整を行ってください。
トリガー
- ユーザーがモーション効果を説明しているが、その名前を知らない場合。
- 設計や実装の議論で、正確なアニメーション用語が必要な場合。
- このスキルを実装やレビューの基準として使用しないでください。
- モーション効果の名前を具体的に尋ねるリクエストには、直接回答する必要があります。アップストリームのInitial Responseは、質問やタスクなしでスキルが呼び出された場合にのみ適用されます。
ワークフロー
- アップストリームの用語集を使用して、効果を命名し、曖昧さを解消します。
- 回答は簡潔に保ち、命名リクエストをUI作業に変えないでください。
- 実装やレビューが続く場合は、
docs/ai/rules/frontend.mdとdocs/ai/skills/anim/SKILL.mdを読み込んでください。これらのリポジトリの契約が優先されます。
チェックリスト
- 回答は最も正確な用語集の用語から始まります。
- 近い代替案は、用語を作り出すことなく区別されています。
- 実装に関するアドバイスはすべてCoreのフロントエンドおよびモーションルールに委ねられています。
初期応答
このスキルが特定の質問なしで最初に呼び出された場合、以下のようにのみ応答します:
あなたが説明するモーション効果に名前を付ける準備はできています。私の知識はEmil Kowalskiのアニメーション哲学に基づいています。
あいまいなモーションや効果の説明を正確な用語に変換し、ユーザーが何を求めればよいかを明確にします。
クイックスタート
ユーザーが効果をざっくりと説明します。あなたは以下の形式で一致する用語を返します:
**Stagger(連続)** — 複数のアイテムを、それぞれの間に小さな遅延を設けて次々にアニメーションさせ、カスケード効果を生み出します。
複数の用語が該当する可能性がある場合は、最適なものを最初に挙げ、1~2つの代替案をそれぞれ一行で違いを説明してリストします。
指示
- キーワードではなく意図を読む。 ユーザーは自分が 見ている または 感じている もの(「バネみたい」「スライドして消える」「自分で描き込む」)を説明し、技術名ではありません。その感覚を以下の用語集にマッピングします。
- 用語集をそのまま引用する。 その説明は信頼できるものです。そのまま使用し、言い換えないでください。
- 近い用語を区別する。 二つの用語が競合する場合(クリップパス 対 マスク、Pop in 対 バウンス、共有要素トランジション 対 レイアウトアニメーション)は、ユーザーが選択できるように対比させます。
- 完全に一致するものがない場合、 最も近い用語を挙げ、それが近似であることを明確に述べるか、用語集の語彙で効果を説明します(例:「それは Scale-in エントランスの スタガー です」)。
- この用語集の範囲内に留める。 用語が本当にここにない場合は、そのように伝え、新しい用語を作り出さないでください。ただし、これらの単語を使って概念を説明することは許可されます。
- 簡潔に保つ。 命名の質問には名前を求めているのであって、論文を求めているわけではありません。用語で始め、求められた場合にのみ展開します。
例
例1 — 感覚ベース ユーザー:「ポップオーバーが、クリックしたボタンから中央ではなく、そのボタンから生えているように見えるのは何て言うの?」 出力:
**Origin-aware animation(起点認識アニメーション)** — 要素がトリガーからアニメーションして現れるものです。例えば、ポップオーバーがデフォルトのCSSのように中央からではなく、それを開いたボタンから成長するように見えます。
例2 — 曖昧性の解消 ユーザー:「一つの画像が別の画像に変わるあれ。」 出力:
**Morph(モーフィング)** — ある形状が滑らかに別の形状に変わります。例:Dynamic Island。
近い代替案:
- **Crossfade(クロスフェード)** — 同じ位置で単純に互いにフェードオーバーする場合。
- **Shared element transition(共有要素トランジション)** — 要素が一つの位置から別の位置へ移動し変形する場合。
例3 — 物理感覚 ユーザー:「あのiOSのスクロールで、引きすぎると抵抗があってパチンと戻るやつ。」 出力:
**Rubber-banding(ラバーバンディング)** — 境界を超えてドラッグしたときの抵抗とスナップバック(iOSのオーバースクロール感覚)。
用語集
プロジェクトの /vocabulary ページを反映した厳選されたスナップショット。どちらかが変更された場合は、両方を同期させてください。
エントランス & イグジット — 要素の出現と消失方法
- Fade in / Fade out — 要素が透明度を変えることで出現または消滅します。
- Slide in — 要素が画面外(左、右、上、または下)からスライドインして入場します。
- Scale in — 要素が出現時に小さいサイズからフルサイズに拡大します。多くの場合、フェードと組み合わせます。
- Pop in — 要素がわずかにオーバーシュートして出現し、バウンドして所定の位置に収まるように見えます。
- Reveal — コンテンツが徐々に現れます。多くの場合、クリップパスやマスクをアニメーションさせます。
- Enter / Exit — 要素が画面に追加または削除されるときに再生されるアニメーション。
シーケンス & タイミング — 複数の要素や瞬間の調整
- Keyframes — アニメーション内の定義されたポイント(0%、50%、100%)で、ブラウザがその間を補間します。
- Interpolation / Tween — 開始値と終了値の間のすべての中間フレームを生成し、動きを連続的にします。
- Stagger(連続) — 複数のアイテムを、それぞれの間に小さな遅延を設けて次々にアニメーションさせ、カスケード効果を生み出します。
- Orchestration(オーケストレーション) — 複数のアニメーションのタイミングを意図的に調整し、一つの協調した動きのように感じさせます。
- Delay — アニメーションが開始するまでの時間。
- Duration — アニメーションにかかる時間。
- Fill mode — アニメーションの開始前または終了後に、要素が最初または最後のフレームのスタイルを保持するかどうかを指定します(例:forwards)。
- Stepped animation — カウントダウンタイマーのように、離散的なステップに分割されたアニメーション。
移動 & トランスフォーム — 要素の位置、サイズ、角度の変更
- Translate — 要素をX軸またはY軸に沿って移動させます。
- Scale — 要素を拡大または縮小します。
- Rotate — 要素を点を中心に回転させます。
- Skew — 要素をX軸またはY軸に沿って傾け、長方形の形状からせん断します。
- 3D tilt / Flip — 3D空間で回転(rotateX / rotateY)させ、奥行きを加えます。
- Perspective — 3D効果の強さ。値が小さいほど奥行きが強調され、視聴者が近くにいるように見えます。
- Transform origin — スケールや回転が成長または回転する基点。
- Origin-aware animation(起点認識アニメーション) — 要素がトリガーからアニメーションして現れるものです。例えば、ポップオーバーがデフォルトのCSSのように中央からではなく、それを開いたボタンから成長するように見えます。
状態間のトランジション — ある状態、ビュー、または要素を別のものに接続
- Crossfade — ある要素がフェードアウトするのと同時に別の要素が同じ位置でフェードインします。
- Continuity transition — 視覚的に前後を接続することで、ユーザーの方向感覚を維持する変更。例えば、同じ長方形を大きくしたり小さくしたりする。
- Morph(モーフィング) — ある形状が滑らかに別の形状に変わります。例:Dynamic Island。
- Shared element transition(共有要素トランジション) — 要素が一つの位置から別の位置へ移動し変形します。サムネイルがカードに拡大するようなものです。
- Layout animation — 要素のサイズや位置が変更されたとき、スナップせずに新しい場所へアニメーションします。
- Accordion / Collapse — セクションが滑らかに高さを拡大・縮小して、コンテンツを表示または非表示にします。
- Direction-aware transition — コンテンツが進むときは一方向、戻るときは逆方向にスライドし、ナビゲーションに方向感覚を与えます。
スクロール — スクロールやビュー間の移動に連動したモーション
- Scroll reveal — 要素がビューポートに入るときにフェードインまたはスライドインします。
- Scroll-driven animation — 進行度がスクロール位置に直接結びついたアニメーション。
- Parallax — スクロール時に背景と前景が異なる速度で移動し、奥行きを生み出します。
- Page transition — あるページやルートから別のページやルートに遷移するときに再生されるアニメーション。
- View transition — ブラウザが二つの状態やページの間をモーフィングし、共有要素を接続します。
フィードバック & インタラクション — ユーザーのアクションへの応答
- Hover effect — カーソルが要素の上に移動したときの視覚的な変化。
- Press / Tap feedback — 要素がクリックされたときの微妙なスケールダウンで、物理的な感触を与えます。
- Hold to confirm — ユーザーがボタンを長押ししている間に満たされるプログレス効果。
- Drag — 要素をつかんで移動させる。離したときの慣性(モメンタム)を伴うことが多い。
- Drag to reorder — リスト内のアイテムをドラッグして並べ替え、他のアイテムは移動して場所を空けます。
- Swipe to dismiss — ドロワーやトーストのように、要素を画面外にドラッグして閉じます。
- Rubber-banding(ラバーバンディング) — 境界を超えてドラッグしたときの抵抗とスナップバック(iOSのオーバースクロール感覚)。
- Shake / Wiggle — エラーや拒否された入力を示す素早い左右のジッター。
- Ripple — タップした点から広がる円で、押下を確認します。
イージング — アニメーション中の速度変化の仕方
- Easing — アニメーションが加速または減速する割合。
- Ease-out — 速く始まり、遅く終わる。ほとんどのUIやユーザーの操作に応答するもののデフォルト。
- Ease-in — 遅く始まり、速く終わる。通常は避けられる。もっさりした感じになる可能性あり。
- Ease-in-out — 遅く、速く、遅く。すでに画面上にある要素がAからBに移動するのに適している。
- Linear — 一定の速度。UIでは避け、スピナーやマーキーに限定する。
- Cubic-bezier — 精密な制御のために自分で定義するカスタムイージング曲線。
- Asymmetric easing — 加速と減速が異なるレートで行われる曲線。対称的なものよりも生き生きと感じられる。
スプリングアニメーション — 固定時間のイージングに代わる物理ベースのモーション
- Spring — 設定された時間ではなく、物理(張力、質量、減衰)によって駆動されるモーション。
- Stiffness / Tension — スプリングが目標に向かって引っ張る強さ。高いほどパリッと感じられる。
- Damping — スプリングが落ち着く速さ。減衰が低いほど、バウンドと発振が多くなる。
- Mass — アニメーションする要素の重さ。質量が大きいほど、動きが遅く、のろのろした感じになる。
- Bounce — オーバーシュートして落ち着くスプリングで、遊び心を加える。
- Perceptual duration — スプリングが終わったと感じられる時間。実際にはその下で微小に落ち着き続けている。
- Momentum — 特にドラッグや割り込みの後、速度を運ぶモーション。
- Velocity — 要素が動く速さと方向。スプリングは割り込まれたときに次のアニメーションに速度を引き継ぐため、フリックされた要素はその速度を維持する。
- Interruptible animation — 飛行中に滑らかに方向転換できるアニメーション。最初に終了する必要はない。
ループ & アンビエントモーション — 自律的に実行されるアニメーション
- Marquee — テキストやコンテンツが連続的にループでスクロールする。
- Loop — アニメーションが繰り返される。回数指定または無限。
- Alternate (yoyo) — ループが順方向に再生された後、各イテレーションで逆方向に再生される。先頭にジャンプして戻るわけではない。
- Orbit — 要素が別の要素の周りを連続的な軌道で回る。
- Pulse — 注意を引くための、穏やかな繰り返しのスケールまたは透明度の変化。
- Float — 穏やかで連続的な上下のドリフト。静的な要素を生き生きと無重力に見せる。
- Idle animation — 要素が単にそこにあり、操作されるのを待っている間に再生される微妙なモーション。
ポリッシュ & エフェクト — 良いものを素晴らしいものに変える小さなタッチ
- Blur — 要素を柔らかくしたり、微小な欠陥を隠すために使用されるぼかしフィルター。
- Clip-path — 要素を形状にクリッピング。リビール、マスク、ビフォー/アフタースライダーに使用。
- Mask — 形状やグラデーションを使用して要素の一部を非表示または表示する。クリップパスと似ているが、柔らかくフェード可能なエッジを持つ。
- Before / after slider — 二つの重ね合わせた画像を比較するためにワイプするドラッグ可能な仕切り。
- Line drawing — 目に見えないペンでなぞるように、SVGパスが自分自身を描画する。
- Text morph — テキストが変更されたときに文字ごとにアニメーションし、新しい値に注意を引く。
- Skeleton / Shimmer — コンテンツの読み込み中に表示される、動く光沢のあるプレースホルダー。
- Number ticker — 数字が値に向かって回転またはカウントアップする。
- Tabular numbers — 固定幅の数字。数値が変わっても位置がずれない。ティッカー、タイマー、カウンターに不可欠。
- Typewriter — タイプライターで打つように、テキストが一度に一文字ずつ表示される。
パフォーマンス — モーションをカクつかせず滑らかに保つもの
- Frame rate (FPS) — 1秒間に描画されるフレーム数。60fpsは滑らかなモーションの基準。新しいディスプレイでは120fps。
- Jank — ブラウザがアニメーションについていけずフレームを落としたときに発生する、目に見えるカクつき。
- Dropped frame — ブラウザが描画の締め切りに間に合わなかったフレーム。モーションに小さな引っ掛かりを引き起こす。
- Compositing — GPUに要素を自身のレイヤー上で移動またはフェードさせ、レイアウトやペイントをやり直さないようにする。
- will-change — 要素がまもなくアニメーションすることをブラウザに伝えるCSSのヒント。事前に独自のレイヤーに昇格させることができる。
- Layout thrashing — ブラウザに毎フレームレイアウトの再計算を強制するプロパティ(width、height、top、leftなど)をアニメーションさせ、ジャンクを引き起こす。
知っておくべき原則 — いつ、どのようにアニメーションさせるかを導く概念
- Purposeful animation — モーションは機能を果たすべき — 方向を示す、フィードバックを与える、関係性を示す — 単なる装飾であってはならない。
- Anticipation — 動作の前に反対方向への小さな準備動作。何が起ころうとしているかを示唆する。
- Follow-through — 要素の一部が主な動作の後も動き続け、わずかに落ち着く。重みを加える。
- Squash & stretch — 要素が動くときに変形させ、重さ、速度、柔軟性を伝える。
- Perceived performance — 適切なアニメーションは、実際には速くなくても、インターフェースをより速く感じさせる。
- Frequency of use — ユーザーがアニメーションを見る頻度が高いほど、短く、控えめにする必要がある。
- Spatial consistency — 要素が状態間で自身のIDと位置を維持するようにアニメーションさせ、ユーザーが物がどこへ行ったかを見失わないようにする。
- Hardware acceleration — transformとopacityをアニメーションさせることで、GPUがモーションを滑らかに保てる。
- Reduced motion — ユーザーの prefers-reduced-motion 設定を尊重し、モーションを控えめにする、または削除する。