Animations CSS pour HyperFrames
HyperFrames peut rechercher des animations CSS keyframes via son adaptateur runtime css. Utilisez cela pour des motifs répétés simples, des mouvements de fond, des effets de scintillement, des lueurs, des masques 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-startpour que le temps d'animation local corresponde au clip. - Utilisez
animation-durationetanimation-iteration-countfinies car le repli sur le 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 recherchés soient maintenus avant et après le mouvement actif. - Évitez le JavaScript basé sur l'horloge, l'état déclenché par survol et les bascules de classe dépendant d'événements utilisateur.
L'adaptateur détecte les éléments avec animation-name calculé, recherche leurs poignées Animation du navigateur lorsqu'elles sont disponibles, et se replie sur la 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'Échelonnement
Utilisez des propriétés CSS personnalisées 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, grain et couches de parallaxe subtiles.
- Entrées simples d'un seul élément où une timeline JS complète serait excessive.
À Éviter
- Animations CSS infinies sauf si vous avez vérifié que le navigateur expose des poignées d'animation CSS basées sur WAAPI pouvant être recherchées. Préférez un nombre fini d'itérations couvrant la durée visible.
- Animer des propriétés de mise en page comme
top,left,widthouheightlorsque des transformations suffisent. - Compter sur le survol, le focus, le défilement ou les requêtes média pour déclencher un mouvement critique pour le rendu.
- Changer 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
- 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/CSS_Animations/Using_CSS_animations
- Documentation MDN sur
animation-fill-mode: https://developer.mozilla.org/fr/docs/Web/CSS/animation-fill-mode