Animations CSS pour HyperFrames
HyperFrames peut parcourir les animations CSS basées sur des keyframes via son adaptateur runtime css. Utilisez-le pour des motifs simples et répétés, des mouvements d'arrière-plan, des effets de scintillement, de lueur, de masque et des décorations non séquencées.
Pour la chorégraphie de scènes, 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-startafin que le temps d'animation local corresponde au clip. - Utilisez des
animation-durationetanimation-iteration-countfinis car le fallback par délai négatif ne peut pas représenter une durée illimitée dans des environnements sans animations CSS basées sur WAAPI. - Préférez
animation-fill-mode: bothpour que les états parcourus soient maintenus avant et après le mouvement actif. - Évitez le JavaScript basé sur l'horloge système, les états déclenchés par survol et les toggles de classe dépendant d'événements utilisateur.
L'adaptateur découvre les éléments avec une propriété animation-name calculée, recherche leurs handles Animation natifs du navigateur lorsqu'ils sont disponibles, et se rabat sur une pause avec un animation-delay négatif.
Pattern 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>
Pattern de décalage (stagger)
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.
- Effets de masque, lueur, scintillement, grain et couches de parallaxe subtiles.
- Entrées simples d'un seul élément où une timeline JS complète serait excessive.
Éviter
- Les animations CSS infinies sauf si vous avez vérifié que le navigateur expose des handles Animation CSS basés sur WAAPI et pouvant être parcourus. Préférez un nombre d'itérations fini couvrant la durée visible.
- Les propriétés de layout animées comme
top,left,widthouheightlorsque des transformations fonctionnent. - Le fait de se reposer sur le survol, le focus, le défilement ou les requêtes média pour déclencher un mouvement critique pour le rendu.
- Le changement de classes d'animation après le démarrage, sauf si une autre timeline déterministe contrôle ce changement.
Validation
Après avoir modifié des compositions d'animations CSS :
npx hyperframes lint
npx hyperframes validate
Crédits et références
- Source de l'adaptateur HyperFrames :
packages/core/src/runtime/adapters/css.ts. - Documentation MDN sur les animations CSS : https://developer.mozilla.org/fr/docs/Web/CSS/animation
- MDN
animation-fill-mode: https://developer.mozilla.org/fr/docs/Web/CSS/animation-fill-mode