Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

animation-name: propojení prvku s klíčovými snímky

Vyberte pojmenovaná pravidla @keyframes a koordinujte několik animací stejného prvku.

Verze: CSS Modules

Syntaxe

animation-name: Fade, lift;

animation-name vybírá pravidlo @keyframes pro každou animaci. Názvy rozlišují velikost písmen: Fade a fade jsou odlišné. Bez odpovídajícího pravidla nevznikne animace ani při nastavených ostatních časových vlastnostech. Počáteční none rovněž znamená žádnou animaci; existující název stále potřebuje vhodné časování, protože nulový cyklus nezobrazuje běžnou postupnou změnu. Název snímků může být povolený vlastní identifikátor nebo řetězec v uvozovkách; none bez uvozovek zůstává vypínacím slovem.

Více animací oddělte čárkami. Seznam názvů určuje jejich počet a kratší seznamy dob nebo jiných nastavení se opakují, aby mu odpovídaly; animace běží současně, nikoli automaticky ve frontě. Při výchozí kompozici replace má ze dvou efektů stejné vlastnosti během svého působení přednost pozdější v seznamu názvů. Pojmenování animace nezpůsobuje její dědění dětmi. Odstranění názvu odstraní efekt včetně výplně.

Příklad definuje Fade, lift a dim. Chybné fade vytvoří nula objektů animace; Fade v čase 500ms dává neprůhlednost 0.5. Fade, lift vytvoří dvě animace sdílející jedinou délku 1s a lift posune prvek o 50px. Fade, dim rovněž vytvoří dva objekty, ale dim v odečítaném čase určuje neprůhlednost 0.3. Změna animation-name na none ponechá nula animací a obnoví podkladovou neprůhlednost 0.3.

Příklady

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);

Výsledek

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

Provedeno v Chromium 157.0.8103.51. Skutečné objekty CSSAnimation a vypočtené styly potvrzují shodu názvů, opakování nastavení seznamů a výchozí nahrazování. Příklad neověřuje aditivní kompozici, názvy v uvozovkách ani rozsah názvů ve stínových stromech.

Zdroje