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

CKTIS / CSS

::view-transition-old() — a imagem do estado anterior

O pseudo-elemento ::view-transition-old() representa uma captura estática do estado anterior durante uma transição de vista. Permite animar a imagem de saída independentemente do novo estado, sem aplicar estilos ao elemento DOM anterior.

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

Sintaxe

::view-transition-old(<pt-name-and-class-selector>)
<pt-name-and-class-selector> = <pt-name-selector> <pt-class-selector>? | <pt-class-selector>
<pt-name-selector> = '*' | <custom-ident>
<pt-class-selector> = ['.' <custom-ident>]+

::view-transition-old(card) seleciona a captura do estado anterior associada a view-transition-name: card. É um elemento substituído e um filho de ::view-transition-image-pair(card), não o nó DOM anterior. Se não existir um estado anterior, este pseudo-elemento não é criado; ::view-transition-new() representa o novo estado.

O argumento * seleciona todas essas capturas, enquanto root é o nome de transição predefinido do elemento raiz do documento. O nível 2 também aceita classes de view-transition-class, como ::view-transition-old(.tile) e ::view-transition-old(card.tile). Não são permitidos espaços na parte do argumento que contém o nome e as classes; não se trata de classes HTML.

Por predefinição, a imagem antiga desvanece-se. Uma animation personalizada pode substituir essa animação; object-fit e object-position controlam a imagem como acontece com outros elementos substituídos. :only-child corresponde à captura antiga quando não existe uma captura nova correspondente.

O exemplo atualiza um cartão através de document.startViewTransition() e anima a opacidade da imagem antiga durante 1200 ms. Sem a API, atualiza o conteúdo imediatamente. É necessária uma verificação local: o suporte da API não garante o suporte de todas as sintaxes de seletores nem que uma animação seja executada.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>Old snapshot</title>
<style>
  html { view-transition-name: none; }
  #card {
    view-transition-name: card;
    width: 12rem;
    padding: 2rem;
    background: navy;
    color: white;
  }
  #card.changed { background: darkgreen; }
  ::view-transition-old(card) {
    z-index: 1;
    animation: leave 1200ms linear both;
  }
  ::view-transition-new(card) { animation: none; }
  @keyframes leave {
    from { opacity: 1; }
    to { opacity: 0; }
  }
</style>
<p id="card">Before</p>
<button id="run" type="button">Run</button>
<script>
  const card = document.querySelector('#card');
  const button = document.querySelector('#run');
  button.addEventListener('click', async () => {
    button.disabled = true;
    const update = () => {
      card.classList.add('changed');
      card.textContent = 'After';
    };
    if (typeof document.startViewTransition !== 'function') {
      update();
      return;
    }
    const transition = document.startViewTransition(update);
    await transition.finished;
  });
</script>

Resultado

Initial: navy card displaying Before. After Run: darkgreen card displaying After; the button stays disabled. If the view transition runs, the old capture fades from full opacity to transparent over 1200 ms, revealing the new capture beneath it. Without the API, the update is immediate.

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