CKTIS / CSS
view-transition-name — assegnare un nome a un elemento in una transizione di vista
La proprietà view-transition-name contrassegna un elemento da acquisire separatamente durante una transizione di vista. I nomi corrispondenti abbinano il suo stato visivo precedente e quello nuovo; la dichiarazione da sola non avvia una transizione.
Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintassi
view-transition-name: none | <custom-ident> | auto | match-element;view-transition-name consente di animare un elemento acquisito indipendentemente dal resto della pagina. Il valore iniziale è none; la proprietà non è ereditata. none disattiva l’acquisizione separata, ma non rimuove l’elemento dall’immagine di un antenato acquisito.
Un identificatore personalizzato come card abbina gli stati visivi precedente e nuovo, anche se appartengono a nodi DOM diversi. Il nome deve essere univoco tra gli elementi acquisiti simultaneamente durante la transizione; i duplicati interrompono l’animazione, ma non l’aggiornamento del DOM in sé. Personalizza il gruppo con ::view-transition-group(card).
La bozza di livello 2 descrive anche match-element, che genera un nome in base all’identità dell’elemento, e auto, che può usare l’id dell’elemento e, in caso contrario, genera un nome. Queste parole chiave non sono identificatori personalizzati. Una bozza di specifica non garantisce il supporto dei browser.
L’esempio avvia una transizione con document.startViewTransition() e modifica la posizione di card. Se la funzionalità non è supportata, esegue un normale aggiornamento. La media query prefers-reduced-motion: reduce imposta a 0s la durata dell’animazione solo per il gruppo card; la transizione predefinita del gruppo root rimane attiva.
Esempi
<!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>Risultato
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.Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.