KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

view-transition-name — een element benoemen in een view transition

De eigenschap view-transition-name markeert een element voor onafhankelijke vastlegging tijdens een view transition. Overeenkomende namen koppelen de oude en nieuwe visuele toestand; de declaratie alleen start geen transition.

Versie: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntax

view-transition-name: none | <custom-ident> | auto | match-element;

view-transition-name maakt het mogelijk een vastgelegd element onafhankelijk van de rest van de pagina te animeren. De beginwaarde is none; de eigenschap wordt niet overgeërfd. none schakelt de afzonderlijke vastlegging uit, maar verwijdert het element niet uit de afbeelding van een vastgelegde voorouder.

Een eigen identifier zoals card koppelt oude en nieuwe visuele toestanden, zelfs als ze bij verschillende DOM-nodes horen. De naam moet uniek zijn onder elementen die tijdens de transition tegelijk worden vastgelegd; dubbele namen breken de animatie af, maar niet de DOM-update zelf. Pas de groep aan met ::view-transition-group(card).

Het Level 2-concept beschrijft ook match-element, dat een naam genereert op basis van de identiteit van het element, en auto, dat de id van het element kan gebruiken en anders een naam genereert. Deze keywords zijn geen eigen identifiers. Een concept van een specificatie garandeert geen browserondersteuning.

Het voorbeeld start een transition met document.startViewTransition() en verandert de positie van card. Zonder ondersteuning voert het een gewone update uit. De mediaquery prefers-reduced-motion: reduce zet de animatieduur alleen voor de groep card op 0s; de standaardovergang voor de groep root blijft actief.

Voorbeelden

<!doctype html>
<meta charset="utf-8">
<title>view-transition-name</title>
<style>
  #card {
    view-transition-name: card;
    width: 120px;
    padding: 16px;
    background: navy;
    color: white;
  }
  #card.moved { margin-left: 160px; }
  ::view-transition-group(card) { animation-duration: 600ms; }
  @media (prefers-reduced-motion: reduce) {
    ::view-transition-group(card) { animation-duration: 0s; }
  }
</style>
<button id="move" type="button">Move</button>
<div id="card">A</div>
<script>
  const button = document.querySelector('#move');
  const card = document.querySelector('#card');
  button.addEventListener('click', async () => {
    button.disabled = true;
    const update = () => card.classList.toggle('moved');
    try {
      if (document.startViewTransition &&
          CSS.supports('view-transition-name', 'card')) {
        const transition = document.startViewTransition(update);
        await transition.finished;
      } else {
        update();
      }
    } finally {
      button.disabled = false;
    }
  });
</script>

Resultaat

After the first click: card.classList.contains('moved') === true. After the second completed click: false. With supported view transitions, the card changes position through its named transition group; otherwise it moves immediately.

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen