Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / CSS

view-transition-name — pomenovanie prvku v prechode zobrazenia

Vlastnosť view-transition-name označuje prvok, ktorý sa má počas prechodu zobrazenia zachytiť samostatne. Zhodné názvy spárujú jeho starý a nový vizuálny stav; samotná deklarácia prechod nespustí.

Verzia: 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 umožňuje animovať zachytený prvok nezávisle od zvyšku stránky. Počiatočná hodnota je none; vlastnosť sa nededí. none vypne samostatné zachytenie, ale neodstráni prvok z obrazu zachyteného predka.

Vlastný identifikátor, napríklad card, spáruje starý a nový vizuálny stav, aj keď patria rôznym uzlom DOM. Názov musí byť jedinečný medzi prvkami zachytenými súčasne počas prechodu; duplicitné názvy prerušia animáciu, nie samotnú aktualizáciu DOM. Skupinu možno upraviť pomocou ::view-transition-group(card).

Návrh úrovne 2 opisuje aj match-element, ktoré generuje názov na základe identity prvku, a auto, ktoré môže použiť id prvku a inak názov vygeneruje. Tieto kľúčové slová nie sú vlastné identifikátory. Návrh špecifikácie nezaručuje podporu v prehliadačoch.

Príklad spustí prechod pomocou document.startViewTransition() a zmení polohu prvku card. Bez podpory vykoná bežnú aktualizáciu. Dotaz na médiá prefers-reduced-motion: reduce nastaví trvanie animácie na 0s iba pre skupinu card; predvolený prechod skupiny root zostáva aktívny.

Prí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ýsledok

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ýsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje