Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes