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

CKTIS / CSS

::view-transition-image-pair() — contentor do par de imagens da transição

O pseudo-elemento ::view-transition-image-pair() agrupa as imagens correspondentes do estado antigo e do novo durante uma transição de vista. Permite recortar as imagens em conjunto e controlar o isolamento da sua mistura.

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

Sintaxe

::view-transition-image-pair(<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-image-pair() é um contentor gerado dentro do ::view-transition-group() correspondente. Contém ::view-transition-old(), ::view-transition-new() ou ambos, por esta ordem. Não é um elemento DOM comum: representa imagens da transição, não o próprio elemento de origem.

O argumento card corresponde ao nome definido através de view-transition-name: card, enquanto * corresponde a todos os nomes. O nível 2 também permite classes view-transition-class, como ::view-transition-image-pair(.tile) ou ::view-transition-image-pair(card.tile). Não são permitidos espaços em branco entre o nome e as classes nem entre componentes das classes. () vazio não é um seletor válido.

Os estilos predefinidos da transição aplicam isolation: isolate ao contentor apenas quando estão presentes tanto a imagem do estado antigo como a do novo. Isto impede que as imagens se misturem com conteúdo fora do par. Normalmente, aplicam-se estilos ao grupo ou às imagens individuais; este contentor é útil para as recortar em conjunto. No exemplo, os cantos arredondados só existem durante a transição, porque a regra não altera #card.

O documento de nível 2 é um rascunho, não uma garantia de suporte. Verifique o exemplo no navegador de destino; a disponibilidade de document.startViewTransition não comprova o suporte de todas as variantes do seletor.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Image pair clipping</title>
<style>
  :root { view-transition-name: none; }
  #card {
    view-transition-name: card;
    width: 180px;
    padding: 32px;
    background: navy;
    color: white;
  }
  #card.changed { background: maroon; }
  ::view-transition-group(card) { animation-duration: 2s; }
  ::view-transition-image-pair(card) {
    border-radius: 32px;
    overflow: clip;
  }
</style>
<button id="change" type="button">Change</button>
<p id="card">Before</p>
<script>
  const button = document.querySelector('#change');
  const card = document.querySelector('#card');
  button.addEventListener('click', async () => {
    button.disabled = true;
    const update = () => {
      card.classList.add('changed');
      card.textContent = 'After';
    };
    if (!document.startViewTransition) {
      update();
      return;
    }
    const transition = document.startViewTransition(update);
    await transition.finished;
  });
</script>
</html>

Resultado

Before → After

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