Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

view-transition-name — nazwa elementu w przejściu widoku

Właściwość view-transition-name oznacza element do niezależnego przechwycenia podczas przejścia widoku. Zgodne nazwy łączą jego stary i nowy stan wizualny; sama deklaracja nie uruchamia przejścia.

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

Składnia

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

view-transition-name pozwala animować przechwycony element niezależnie od reszty strony. Wartość początkowa to none; właściwość nie jest dziedziczona. none wyłącza osobne przechwycenie, ale nie usuwa elementu z obrazu przechwyconego przodka.

Własny identyfikator, np. card, łączy stary i nowy stan wizualny, nawet gdy pochodzą z różnych węzłów DOM. Nazwa musi być unikalna wśród elementów przechwytywanych jednocześnie w danym przejściu; duplikaty przerywają animację, nie samą aktualizację DOM. Wygląd grupy można dostosować przez ::view-transition-group(card).

Projekt Level 2 opisuje też match-element, które generuje nazwę na podstawie tożsamości elementu, oraz auto, które może wykorzystać jego id, a w przeciwnym razie generuje nazwę. Te słowa nie są własnymi identyfikatorami. Projekt specyfikacji nie stanowi gwarancji obsługi w przeglądarce.

Przykład uruchamia przejście przez document.startViewTransition() i zmienia położenie card. Bez obsługi wykonuje zwykłą aktualizację. Zapytanie o media prefers-reduced-motion: reduce ustawia czas trwania animacji na 0s tylko dla grupy card; domyślne przejście grupy root pozostaje włączone.

Przykłady

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

Wynik

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.

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła