WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

view-transition-name – ein Element in einem View-Übergang benennen

Die Eigenschaft view-transition-name kennzeichnet ein Element, das während eines View-Übergangs unabhängig erfasst werden soll. Übereinstimmende Namen verknüpfen seinen alten und neuen visuellen Zustand; die Deklaration allein startet keinen Übergang.

Version: 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 ermöglicht es, ein erfasstes Element unabhängig vom Rest der Seite zu animieren. Der Anfangswert ist none; die Eigenschaft wird nicht vererbt. none deaktiviert die separate Erfassung, entfernt das Element aber nicht aus dem Bild eines erfassten Vorfahren.

Ein eigener Bezeichner wie card verknüpft alte und neue visuelle Zustände, selbst wenn sie zu unterschiedlichen DOM-Knoten gehören. Der Name muss unter den Elementen, die während eines Übergangs gleichzeitig erfasst werden, eindeutig sein; doppelte Namen brechen die Animation ab, nicht aber die DOM-Aktualisierung selbst. Die Gruppe lässt sich mit ::view-transition-group(card) anpassen.

Der Level-2-Entwurf beschreibt außerdem match-element, das einen Namen anhand der Elementidentität erzeugt, sowie auto, das die id des Elements verwenden kann und andernfalls einen Namen erzeugt. Diese Schlüsselwörter sind keine eigenen Bezeichner. Ein Spezifikationsentwurf garantiert keine Browserunterstützung.

Das Beispiel startet mit document.startViewTransition() einen Übergang und ändert die Position von card. Ohne Unterstützung wird eine gewöhnliche Aktualisierung ausgeführt. Die Medienabfrage prefers-reduced-motion: reduce setzt die Animationsdauer nur für die Gruppe card auf 0s; der Standardübergang für die Gruppe root bleibt aktiv.

Beispiele

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

Ergebnis

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.

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen