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.