CKTIS / CSS
animation-name : relier un élément aux images clés
Sélectionnez des règles @keyframes nommées et coordonnez plusieurs animations sur le même élément.
Version : CSS Modules
Syntaxe
animation-name: Fade, lift;animation-name sélectionne la règle @keyframes de chaque animation. Les noms sont sensibles à la casse : Fade et fade sont différents. L’absence de règle correspondante ne crée aucune animation, même si d’autres propriétés temporelles sont présentes. Le mot-clé initial none signifie également aucune animation ; un nom existant nécessite encore un réglage temporel adapté, car un cycle de durée nulle ne montre pas une évolution progressive ordinaire. Un nom d’images clés peut être un identifiant personnalisé autorisé ou une chaîne entre guillemets ; none sans guillemets reste le mot-clé de désactivation.
Séparez plusieurs animations par des virgules. La liste des noms détermine leur nombre, et les listes plus courtes de durées ou d’autres paramètres se répètent pour y correspondre ; les animations fonctionnent ensemble au lieu de s’enchaîner automatiquement. Avec la composition replace par défaut, si deux effets d’animation ciblent la même propriété, le plus tardif dans la liste des noms est prioritaire pendant qu’il s’applique. Nommer une animation ne la rend pas héritée par les éléments enfants. Retirer son nom retire son effet, remplissage compris.
L’exemple définit Fade, lift et dim. Le nom mal écrit fade produit zéro objet d’animation ; Fade donne une opacité de 0.5 à 500ms. Fade, lift crée deux animations partageant le seul réglage de durée 1s, et lift déplace l’élément de 50px. Fade, dim crée aussi deux objets, mais dim fournit l’opacité 0.3 à l’instant lu. Passer animation-name à none laisse zéro animation et rétablit l’opacité sous-jacente 0.3.
Exemples
const style=document.createElement('style');style.textContent='@keyframes Fade{from{opacity:0}to{opacity:1}} @keyframes lift{from{transform:translateX(0)}to{transform:translateX(100px)}} @keyframes dim{from{opacity:0.2}to{opacity:0.4}}';document.head.append(style);
const el=document.createElement('div');el.style.cssText='opacity:0.3;animation-duration:1s;animation-timing-function:linear;animation-fill-mode:both;animation-play-state:paused';document.body.append(el);
const apply=names=>{el.style.animationName=names;const animations=el.getAnimations();for(const animation of animations)animation.currentTime=500;return animations};
const missing=apply('fade').length,matched=apply('Fade');const opacity=getComputedStyle(el).opacity;
const pair=apply('Fade, lift');const movement=new DOMMatrixReadOnly(getComputedStyle(el).transform).m41;
const conflict=apply('Fade, dim');const winner=getComputedStyle(el).opacity;
const none=apply('none').length;
console.log('missing='+missing+'; matched='+matched.length+'; opacity='+opacity);
console.log('names='+pair.map(animation=>animation.animationName).join(',')+'; duration='+pair.map(animation=>animation.effect.getComputedTiming().duration).join(',')+'; movement='+movement);
console.log('conflict='+winner+'; count='+conflict.length+'; none='+none+'; restored='+getComputedStyle(el).opacity);Résultat
missing=0; matched=1; opacity=0.5 names=Fade,lift; duration=1000,1000; movement=50 conflict=0.3; count=2; none=0; restored=0.3
Exécuté dans Chromium 157.0.8103.51. De véritables objets CSSAnimation et styles calculés confirment la correspondance des noms, la répétition des réglages de liste et le remplacement par défaut. L’exemple ne teste pas la composition additive, les noms entre guillemets ni la portée des noms dans les arbres fantômes.