CKTIS / CSS
animation-name: collegare un elemento ai fotogrammi chiave
Seleziona regole @keyframes con nome e coordina più animazioni sullo stesso elemento.
Versione: CSS Modules
Sintassi
animation-name: Fade, lift;animation-name seleziona la regola @keyframes per ogni animazione. I nomi distinguono maiuscole e minuscole: Fade e fade sono diversi. Se manca una regola corrispondente, non viene creata alcuna animazione, anche in presenza di altre proprietà temporali. Anche la parola chiave iniziale none significa nessuna animazione; un nome esistente richiede comunque tempi appropriati, perché un ciclo di durata zero non mostra una normale variazione graduale. Il nome dei fotogrammi può essere un identificatore personalizzato consentito o una stringa tra virgolette; none senza virgolette resta la parola di disattivazione.
Usa le virgole per più animazioni. L’elenco dei nomi ne determina il numero e gli elenchi più corti di durate o altri parametri si ripetono per corrispondervi; le animazioni procedono insieme invece di mettersi automaticamente in coda. Con la composizione replace predefinita, se due effetti animano la stessa proprietà, quello successivo nell’elenco dei nomi ha precedenza mentre si applica. Dare un nome all’animazione non la rende ereditata dagli elementi figli. Rimuovere il nome elimina il suo effetto, compreso qualsiasi riempimento.
L’esempio definisce Fade, lift e dim. Il nome errato fade produce zero oggetti di animazione; Fade a 500ms dà opacità 0.5. Fade, lift crea due animazioni che condividono il singolo parametro di durata 1s, e lift sposta l’elemento di 50px. Anche Fade, dim crea due oggetti, ma dim fornisce opacità 0.3 nell’istante letto. Cambiare animation-name in none lascia zero animazioni e ripristina l’opacità sottostante 0.3.
Esempi
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);Risultato
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
Eseguito in Chromium 157.0.8103.51. Oggetti CSSAnimation reali e stili calcolati confermano corrispondenza dei nomi, ripetizione dei parametri di elenco e sostituzione predefinita. L’esempio non verifica composizione additiva, nomi tra virgolette o ambito dei nomi negli alberi shadow.