KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

animation-composition: een effect vervangen, toevoegen of accumuleren

Kies hoe een geanimeerde waarde wordt gecombineerd met de onderliggende waarde.

Versie: CSS Modules

Syntax

animation-composition: replace | add | accumulate;

animation-composition bepaalt hoe een animatie-effect samengaat met de onderliggende waarde. Die kan uit gewone stijlen of eerdere effecten in de stapel komen; één animatie kan het verschil dus al laten zien. De beginwaarde replace gebruikt de effectwaarde; add en accumulate volgen de optel- en accumulatieregels van de geanimeerde eigenschap. Die bewerkingen zijn niet altijd gewone numerieke optelling.

Bij transformatielijsten voegt optelling de effectlijst achter de onderliggende lijst toe. De volgorde is belangrijk: een bestaande schaal kan een toegevoegde verplaatsing vermenigvuldigen. Accumulatie combineert juist overeenkomstige bewerkingen volgens passende koppelings- of matrixregels; schaalfactoren worden gecombineerd ten opzichte van de neutrale waarde één. De eigenschap vraagt niet om accumulatie tussen opeenvolgende iteraties. Een door komma’s gescheiden lijst hoort bij de animatienamen. Een compositie binnen een keyframe kan voor de betreffende eigenschappen de keuze op effectniveau overschrijven.

Het voorbeeld heeft een onderliggende horizontale verplaatsing van 10px gevolgd door schaal 2, en een constante geanimeerde verplaatsing van 20px gevolgd door schaal 3. Bij 500ms geeft vervangen schaal/verplaatsing 3/20; optellen 6/50; accumuleren 4/30. De laatste schaal is 2+3-1, terwijl de opgetelde verplaatsing 10+2×20 is. Deze gemeten matrixcomponenten verklaren waarom simpelweg alle getallen optellen onjuist zou zijn.

Voorbeelden

const style=document.createElement('style');style.textContent='@keyframes layer{from,to{transform:translateX(20px) scale(3)}}';document.head.append(style);
const values=[];
for(const composition of ['replace','add','accumulate']){const box=document.createElement('div');box.style.cssText='transform:translateX(10px) scale(2);animation:layer 1s linear both paused';box.style.animationComposition=composition;document.body.append(box);box.getAnimations()[0].currentTime=500;const matrix=new DOMMatrix(getComputedStyle(box).transform);values.push(composition+'='+matrix.a+','+matrix.e)}
console.log(values.join('; '));

Resultaat

replace=3,20; add=6,50; accumulate=4,30

Elke modus gebruikt een afzonderlijk aangemaakt element met identieke keyframes en een expliciet meettijdstip. Het resultaat geldt voor deze compatibele transformatielijsten, niet voor alle eigenschappen of alle mogelijke matrixontbindingen.

Bronnen