HyperFrames用CSSアニメーション
HyperFramesは、cssランタイムアダプターを通じてCSSキーフレームアニメーションをシークできます。シンプルな繰り返しモチーフ、背景モーション、きらめき、グロー、マスク、非シーケンス装飾に使用します。
シーンの振り付けにはGSAPの方が明確です。CSSアニメーションは、モーションが1つの要素に属し、固定の継続時間を持つ場合に最適に機能します。
契約
- アニメーション化する要素をランタイム初期化が完了する前にDOMに配置する。
- タイミング要素に
data-start値を設定し、ローカルアニメーション時間がクリップと一致するようにする。 - 有限の
animation-durationとanimation-iteration-countを使用する。なぜなら、負の遅延フォールバックはWAAPI対応CSSアニメーションのない環境で無制限の継続時間を表現できないからです。 animation-fill-mode: bothを推奨する。これにより、アクティブモーションの前後でシークされた状態が保持されます。- 壁時計JavaScript、ホバートリガーの状態、ユーザーイベントに依存するクラスの切り替えは避ける。
アダプターは計算されたanimation-nameを持つ要素を検出し、利用可能な場合はブラウザのAnimationハンドルをシークし、それ以外の場合は負のanimation-delayで一時停止するフォールバックを行います。
基本パターン
<div
id="pulse-ring"
class="clip pulse-ring"
data-start="0"
data-duration="4"
data-track-index="2"
></div>
<style>
.pulse-ring {
width: 280px;
height: 280px;
border: 4px solid rgba(255, 255, 255, 0.7);
border-radius: 50%;
animation-name: pulse-ring;
animation-duration: 1200ms;
animation-timing-function: cubic-bezier(0.2, 0, 0, 1);
animation-iteration-count: 3;
animation-fill-mode: both;
}
@keyframes pulse-ring {
from {
opacity: 0;
transform: scale(0.82);
}
35% {
opacity: 1;
}
to {
opacity: 0;
transform: scale(1.18);
}
}
</style>
スタッガーパターン
CSSカスタムプロパティを使用してキーフレームの重複を避けます:
<div class="clip dots" data-start="1" data-duration="3" data-track-index="3">
<span style="--i: 0"></span>
<span style="--i: 1"></span>
<span style="--i: 2"></span>
</div>
<style>
.dots span {
display: inline-block;
width: 18px;
height: 18px;
margin-right: 10px;
border-radius: 50%;
background: currentColor;
animation: dot-pop 900ms ease-out both;
animation-delay: calc(var(--i) * 120ms);
}
@keyframes dot-pop {
from {
opacity: 0;
transform: translateY(18px) scale(0.75);
}
to {
opacity: 1;
transform: translateY(0) scale(1);
}
}
</style>
適切な用途
- 既知の繰り返し回数を持つ装飾ループ。
- マスク、グロー、きらめき、グラデーション、繊細なパララックスレイヤー。
- 完全なJSタイムラインが過剰になるような、単一要素のシンプルなエントランス。
避けるべきこと
- ブラウザがシーク可能なWAAPI対応CSSアニメーションハンドルを公開していることを確認しない限り、無限CSSアニメーションは避ける。可視継続時間をカバーする有限の反復回数を推奨します。
- トランスフォームが機能する場合に、
top、left、width、heightなどのレイアウトプロパティをアニメーション化することは避ける。 - レンダリングクリティカルなモーションをトリガーするために、ホバー、フォーカス、スクロール、メディアクエリに依存することは避ける。
- 起動後にアニメーションクラスを変更することは避ける。ただし、別の決定論的タイムラインがその変更を制御する場合は除く。
検証
CSSアニメーションの構成を編集した後:
npx hyperframes lint
npx hyperframes validate
クレジットと参照
- HyperFramesアダプターソース:
packages/core/src/runtime/adapters/css.ts。 - MDN CSSアニメーションドキュメント:https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/animation
- MDN
animation-fill-mode:https://developer.mozilla.org/en-US/docs/Web/CSS/animation-fill-mode