CKTIS / CSS
view-transition-name — atribuir um nome a um elemento numa transição de vista
A propriedade view-transition-name marca um elemento para captura independente durante uma transição de vista. Nomes correspondentes associam os estados visuais antigo e novo; a declaração, por si só, não inicia uma transição.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
view-transition-name: none | <custom-ident> | auto | match-element;view-transition-name permite animar um elemento capturado independentemente do resto da página. O valor inicial é none; a propriedade não é herdada. none desativa a captura independente, mas não remove o elemento da imagem de um antepassado capturado.
Um identificador personalizado, como card, associa os estados visuais antigo e novo, mesmo que pertençam a nós DOM diferentes. O nome tem de ser único entre os elementos capturados simultaneamente durante a transição; nomes duplicados interrompem a animação, mas não a própria atualização do DOM. Personalize o grupo com ::view-transition-group(card).
O rascunho de nível 2 também descreve match-element, que gera um nome com base na identidade do elemento, e auto, que pode usar o id do elemento e, caso contrário, gera um nome. Estas palavras-chave não são identificadores personalizados. Um rascunho de especificação não garante o suporte dos browsers.
O exemplo inicia uma transição com document.startViewTransition() e altera a posição de card. Sem suporte, realiza uma atualização normal. A media query prefers-reduced-motion: reduce define a duração da animação como 0s apenas para o grupo card; a transição predefinida do grupo root mantém-se ativa.
Exemplos
<!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>Resultado
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.O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.