Animations CSS pour HyperFrames
HyperFrames peut rechercher des animations CSS via son adaptateur runtime css. Utilisez-le pour les motifs répétés simples, les mouvements d'arrière-plan, le scintillement, la lueur, les masques et la décoration non séquencée.
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 des valeurs finies pour
animation-durationetanimation-iteration-count, car la solution de repli 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 recherché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 survol, et les bascules de classes qui dépendent d'événements utilisateur.
L'adaptateur découvre les éléments avec un animation-name calculé, recherche leurs handles Animation du navigateur lorsqu'ils sont disponibles, et se replie sur la mise en pause avec un 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 en décalage (stagger)
Utilisez des propriétés personnalisées CSS pour éviter de dupliquer les images clés :
<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, 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
- Animations CSS infinies, sauf si vous avez vérifié que le navigateur expose des handles d'animation CSS basés sur WAAPI et pouvant être recherchés. 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.
- 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 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/CSS_animations/Using_CSS_animations
- MDN
animation-fill-mode: https://developer.mozilla.org/fr/docs/Web/CSS/animation-fill-mode