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

CKTIS / CSS

::view-transition — raiz da árvore de transição de vista

O pseudo-elemento ::view-transition é a raiz estilizável de uma árvore de transição de vista. Permite aplicar efeitos a toda a árvore de transição, em vez de estilizar separadamente as imagens do estado antigo e do novo.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

::view-transition { /* declarations */ }

::view-transition seleciona a raiz, gerada pelo navegador, de uma árvore de pseudo-elementos de transição de vista. Não aceita argumentos: ::view-transition(root) é inválido. Só gera caixas quando tem elementos descendentes.

Abaixo encontram-se os grupos ::view-transition-group(), que contêm pares de imagens, bem como ::view-transition-old() e ::view-transition-new(). Um efeito aplicado à raiz, como filter, afeta toda a árvore. O seletor não inicia uma transição; no exemplo, essa função é desempenhada por document.startViewTransition().

Numa transição de todo o documento, a camada de transição é desenhada acima do restante conteúdo, incluindo a top layer. O rascunho de nível 2 também descreve transições limitadas a um elemento; não deduza o respetivo suporte a partir do suporte de transições de documentos. @view-transition é uma regra distinta que ativa transições entre documentos, não este pseudo-elemento.

No exemplo, o filtro remove temporariamente as cores da sobreposição de transição, não do conteúdo persistente da página. Sem a API, o texto também muda. A preferência de movimento reduzido encurta a animação para zero. É necessária uma verificação local; um rascunho do editor não confirma o suporte numa versão específica do navegador.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>View transition root</title>
<style>
  body { font: 1.25rem sans-serif; }
  ::view-transition { filter: grayscale(1); }
  ::view-transition-group(root) { animation-duration: 1s; }
  @media (prefers-reduced-motion: reduce) {
    ::view-transition-group(root) { animation-duration: 0s; }
  }
  #state { color: #b00020; }
</style>
<button id="change" type="button">Change</button>
<p id="state">Before</p>
<script>
  const button = document.querySelector('#change');
  const state = document.querySelector('#state');
  button.addEventListener('click', async () => {
    button.disabled = true;
    const update = () => { state.textContent = 'After'; };
    if (typeof document.startViewTransition !== 'function') {
      update();
      return;
    }
    const transition = document.startViewTransition(update);
    await transition.finished;
  });
</script>

Resultado

Initially: Before. After clicking Change: After; the button remains disabled. If the visual transition runs, its overlay is grayscale during the transition; afterward, After is red.

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