Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

animation : une déclaration pour régler toute l’animation

Associez un nom de keyframes aux paramètres temporels sans oublier les valeurs omises et les réinitialisations.

Version : CSS Modules

Syntaxe

animation: travel 1s linear 500ms 2 alternate both paused;

Le raccourci animation décrit une ou plusieurs animations séparées par des virgules. Chaque entrée fournit un nom et des paramètres : durée, courbe de progression, délai, répétitions, direction, remplissage et état de lecture. Définissez séparément les @keyframes référencées. La première durée indiquée est celle de l’animation, la seconde le délai ; une durée négative est invalide, mais un délai négatif est permis. Un mot-clé ambigu est affecté d’abord à un autre paramètre applicable avant d’être interprété comme nom. Des noms distinctifs évitent les surprises.

Les sous-propriétés omises retrouvent leur valeur initiale au lieu de conserver les déclarations précédentes. Dans le cas temporel ordinaire, omettre la durée signifie zéro seconde : il n’y a donc pas de progression visible graduelle. Des propriétés détaillées déclarées ensuite peuvent remplacer le raccourci. Les commandes plus récentes de chronologie et de plage demandent des contrôles de compatibilité spécifiques ; placez leurs réglages explicites après le raccourci pour éviter leur remise à zéro. L’animation n’est pas héritée et une préférence pour moins de mouvements nécessite toujours une solution adaptée.

L’exemple définit un mouvement linéaire d’une seconde, avec un délai de 500ms, deux itérations alternées, un remplissage des deux côtés et un état en pause. Les temps locaux explicites 0,1000,2000,2500ms donnent les couples opacité/translation 0.20/0, 0.50/50, 0.50/50 et 0.20/0. Le délai et la deuxième itération inversée expliquent le milieu répété puis le retour final. Remplacer la déclaration par le seul nom réinitialise à 0s une durée de cinq secondes définie auparavant, ainsi que le délai, la direction, le remplissage et l’état de lecture à leurs valeurs initiales.

Exemples

const style=document.createElement('style');
style.textContent='@keyframes travel{from{opacity:.2;transform:translateX(0px)}to{opacity:.8;transform:translateX(100px)}}';document.head.append(style);
const box=document.createElement('div');box.style.animation='travel 1s linear 500ms 2 alternate both paused';document.body.append(box);
const animation=box.getAnimations()[0];
const samples=[0,1000,2000,2500].map(time=>{animation.currentTime=time;const s=getComputedStyle(box);return Number(s.opacity).toFixed(2)+','+new DOMMatrix(s.transform).m41});
const s=getComputedStyle(box);console.log('settings='+[s.animationName,s.animationDuration,s.animationDelay,s.animationIterationCount,s.animationDirection,s.animationPlayState].join('|'));
console.log('samples='+samples.join(' / '));
box.style.animationDuration='5s';box.style.animation='travel';
const reset=getComputedStyle(box);console.log('reset='+[reset.animationDuration,reset.animationDelay,reset.animationDirection,reset.animationFillMode,reset.animationPlayState].join('|'));

Résultat

settings=travel|1s|0.5s|2|alternate|paused
samples=0.20,0 / 0.50,50 / 0.50,50 / 0.20,0
reset=0s|0s|normal|none|running

Le navigateur évalue de vraies keyframes CSS. Régler currentTime sur la CSSAnimation rend les mesures déterministes ; cela ne teste ni une attente réelle, ni la fréquence d’images, ni une chronologie de défilement.

Sources