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

CKTIS / CSS

view-transition-name — pojmenování prvku v přechodu zobrazení

Vlastnost view-transition-name označuje prvek, který se má během přechodu zobrazení zachytit samostatně. Shodné názvy propojí jeho starý a nový vizuální stav; samotná deklarace přechod nespustí.

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

Syntaxe

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

view-transition-name umožňuje animovat zachycený prvek nezávisle na zbytku stránky. Počáteční hodnota je none; vlastnost se nedědí. none vypne samostatné zachycení, ale neodstraní prvek z obrazu zachyceného předka.

Vlastní identifikátor, například card, propojí starý a nový vizuální stav, i když patří různým uzlům DOM. Název musí být jedinečný mezi prvky zachycenými současně během přechodu; duplicitní názvy přeruší animaci, nikoli samotnou aktualizaci DOM. Skupinu lze upravit pomocí ::view-transition-group(card).

Návrh úrovně 2 popisuje také match-element, které vytváří název na základě identity prvku, a auto, které může použít id prvku, a jinak název vygeneruje. Tato klíčová slova nejsou vlastní identifikátory. Návrh specifikace nezaručuje podporu v prohlížečích.

Příklad spustí přechod pomocí document.startViewTransition() a změní polohu prvku card. Bez podpory provede běžnou aktualizaci. Dotaz na média prefers-reduced-motion: reduce nastaví dobu trvání animace na 0s pouze pro skupinu card; výchozí přechod skupiny root zůstává aktivní.

Příklady

<!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>

Výsledek

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.

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje