CSS-Animationen für HyperFrames
HyperFrames kann CSS-Keyframe-Animationen durch seinen css-Laufzeitadapter suchen. Verwenden Sie dies für einfache wiederholte Motive, Hintergrundbewegungen, Schimmer, Glühen, Masken und nicht sequenzierte Dekoration.
Für Szenenchoreografie ist GSAP in der Regel klarer. CSS-Animationen funktionieren am besten, wenn die Bewegung zu einem Element gehört und eine feste Dauer hat.
Vertrag
- Fügen Sie das animierte Element vor Abschluss der Laufzeitinitialisierung in das DOM ein.
- Geben Sie zeitgesteuerten Elementen einen
data-start-Wert, damit die lokale Animationszeit mit dem Clip übereinstimmt. - Verwenden Sie endliche
animation-durationundanimation-iteration-count, da der Negative-Delay-Fallback eine unbegrenzte Dauer in Umgebungen ohne WAAPI-gestützte CSS-Animationen nicht darstellen kann. - Bevorzugen Sie
animation-fill-mode: both, damit gesuchte Zustände vor und nach der aktiven Bewegung gehalten werden. - Vermeiden Sie Wanduhr-JavaScript, hover-ausgelöste Zustände und Klassenumschaltungen, die von Benutzerereignissen abhängen.
Der Adapter erkennt Elemente mit berechnetem animation-name, sucht deren Browser-Animation-Handles, wenn verfügbar, und fällt auf das Anhalten mit negativem animation-delay zurück.
Grundlegendes Muster
<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>
Gestaffeltes Muster
Verwenden Sie CSS-Benutzereigenschaften, um das Duplizieren von Keyframes zu vermeiden:
<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>
Gute Verwendungszwecke
- Dekorative Schleifen mit bekannter Wiederholungsanzahl.
- Masken, Glühen, Schimmer, Körnung und subtile Parallaxenschichten.
- Einfache Ein-Element-Eingänge, bei denen eine vollständige JS-Zeitleiste übertrieben wäre.
Vermeiden
- Unendliche CSS-Animationen, es sei denn, Sie haben überprüft, ob der Browser suchbare WAAPI-gestützte CSS-Animation-Handles bereitstellt. Bevorzugen Sie eine endliche Iterationsanzahl, die die sichtbare Dauer abdeckt.
- Animieren von Layouteigenschaften wie
top,left,widthoderheight, wenn Transformationen funktionieren. - Sich auf Hover, Fokus, Scrollen oder Medienabfragen zu verlassen, um renderkritische Bewegungen auszulösen.
- Animationsklassen nach dem Start zu ändern, es sei denn, eine andere deterministische Zeitleiste steuert diese Änderung.
Validierung
Nach dem Bearbeiten von CSS-Animation-Kompositionen:
npx hyperframes lint
npx hyperframes validate
Credits und Referenzen
- HyperFrames-Adapterquelle:
packages/core/src/runtime/adapters/css.ts. - MDN CSS-Animation-Dokumentation: 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