Animations CSS pour HyperFrames
HyperFrames peut contrôler les animations CSS keyframes via son adaptateur runtime css. Utilisez cela pour des motifs répétitifs simples, des mouvements de fond, des scintillements, des lueurs, des masques et des décorations non séquencées.
Pour la chorégraphie de scène, GSAP est généralement plus clair. Les animations CSS fonctionnent mieux lorsque le mouvement appartient à un seul élément et a une durée fixe.
Contrat
- Placez l'élément animé dans le DOM avant la fin de l'initialisation du runtime.
- Donnez aux éléments temporisés une valeur
data-startpour que le temps d'animation local corresponde au clip. - Utilisez
animation-durationetanimation-iteration-countfinis, car le repli sur un délai négatif ne peut pas représenter une durée illimitée dans des environnements sans animations CSS basées sur WAAPI. - Privilégiez
animation-fill-mode: bothpour que les états contrôlés soient maintenus avant et après le mouvement actif. - Évitez le JavaScript basé sur l'horloge système, les états déclenchés par le survol et les bascules de classe qui dépendent d'événements utilisateur.
L'adaptateur détecte les éléments avec animation-name calculée, cherche leurs gestionnaires Animation du navigateur lorsqu'ils sont disponibles, et se replie sur une pause avec animation-delay négatif.
Motif de base
<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>
Motif décalé
Utilisez des propriétés personnalisées CSS pour éviter de dupliquer les keyframes :
<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>
Bonnes utilisations
- Boucles décoratives avec un nombre de répétitions connu.
- Masques, lueurs, scintillements, grains et couches de parallaxe subtiles.
- Entrées simples d'un seul élément où une timeline JavaScript complète serait excessive.
À éviter
- Les animations CSS infinies, sauf si vous avez vérifié que le navigateur expose des gestionnaires d'animations CSS basées sur WAAPI contrôlables. Préférez un nombre d'itérations fini couvrant la durée visible.
- Animer des propriétés de mise en page comme
top,left,widthouheightlorsque les transformations fonctionnent. - Compter sur le survol, le focus, le défilement ou les requêtes média pour déclencher un mouvement critique pour le rendu.
- Modifier les classes d'animation après le démarrage, sauf si une autre timeline déterministe contrôle ce changement.
Validation
Après avoir édité des compositions d'animations CSS :
npx hyperframes lint
npx hyperframes validate
Crédits et références
- Code source de l'adaptateur HyperFrames :
packages/core/src/runtime/adapters/css.ts. - Documentation MDN sur les animations 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