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

CKTIS / CSS

::view-transition-group() — grupo de transição de vista

O pseudoelemento ::view-transition-group() representa um grupo de transição de vista com nome. Permite controlar a animação da geometria do grupo e a duração das animações das imagens dos estados anterior e novo que contém.

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

Sintaxe

::view-transition-group(<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-group(card) seleciona o grupo gerado para o nome card, atribuído através de view-transition-name. Não seleciona um elemento DOM. O grupo contém ::view-transition-image-pair(card), que inclui as imagens dos estados anterior e novo. Quando ambos os estados existem, o navegador anima, por predefinição, o tamanho e a transformação do grupo entre eles.

O argumento * seleciona todos os grupos; root é o nome de transição predefinido do elemento do documento. O nível 2 acrescenta seletores de classe, como ::view-transition-group(.tile) e ::view-transition-group(card.tile), associados a view-transition-class, e não ao atributo HTML class. Não são permitidos espaços entre os componentes do argumento. () vazio é inválido.

Aplica o seletor diretamente ao elemento raiz da transição, por exemplo, :root::view-transition-group(card) para uma transição do documento; não o encadeies como ::view-transition::view-transition-group(card). Definir animation-duration no grupo também controla, por predefinição, a duração da animação dos seus descendentes. Não confundas o pseudoelemento com a propriedade view-transition-group, que controla o aninhamento dos grupos.

O exemplo inicia uma atualização através de document.startViewTransition(), reduz o movimento de acordo com prefers-reduced-motion e atualiza sem transição se a funcionalidade não for suportada. O nível 2 é um rascunho; verifica as funcionalidades utilizadas no navegador de destino, independentemente da verificação do âmbito de Chromium 152.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>View transition group</title>
<style>
  :root { view-transition-name: none; }
  #card {
    view-transition-name: card;
    width: 100px;
    height: 80px;
    background: royalblue;
    margin-top: 16px;
  }
  #card.moved { transform: translateX(160px); }
  ::view-transition-group(card) {
    animation-duration: 1s;
    animation-timing-function: linear;
  }
  @media (prefers-reduced-motion: reduce) {
    ::view-transition-group(card) { animation-duration: 0s; }
  }
</style>
<button id="move" type="button">Move</button>
<p id="status" role="status">Ready</p>
<div id="card"></div>
<script>
  const button = document.querySelector('#move');
  const card = document.querySelector('#card');
  const status = document.querySelector('#status');
  button.addEventListener('click', async () => {
    button.disabled = true;
    const update = () => card.classList.toggle('moved');
    try {
      if (document.startViewTransition &&
          CSS.supports('selector(::view-transition-group(card))')) {
        const transition = document.startViewTransition(update);
        await transition.finished;
        status.textContent = 'Finished';
      } else {
        update();
        status.textContent = 'Updated without transition';
      }
    } finally {
      button.disabled = false;
    }
  });
</script>
</html>

Resultado

First click: the blue box ends 160 CSS pixels to the right. With an active supported transition and no reduced-motion preference, movement takes approximately 1 second and the status becomes "Finished". Without support, the box updates immediately and the status becomes "Updated without transition". The next click returns it.

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