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

CKTIS / CSS

view-transition-group — aninhamento de grupos de transição

A propriedade view-transition-group controla a hierarquia de grupos com nome durante uma transição de vista, independentemente da disposição do DOM.

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: normal | contain | nearest | <custom-ident>;

view-transition-group controla o aninhamento de ::view-transition-group(); não atribui um nome a uma transição. Exige que view-transition-name tenha um valor diferente de none.

O valor inicial normal utiliza o grupo contenedor estabelecido pelo antepassado participante mais próximo na árvore plana que tenha view-transition-group: contain. É contain que estabelece o limite de agrupamento para os descendentes. nearest seleciona o antepassado participante mais próximo, independentemente do valor desta propriedade nesse antepassado.

<custom-ident> aponta para um antepassado através de view-transition-name. Se não houver correspondência, o algoritmo do rascunho utiliza o grupo contenedor; a descrição do valor sugere antes a raiz direta — o rascunho é incoerente. O aninhamento utiliza ::view-transition-group-children().

A propriedade não é herdada; a animação é discreta. Não a confundas com o pseudo-elemento ::view-transition-group(). Trata-se de uma funcionalidade de um rascunho de especificação: verifica o comportamento no navegador de destino.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Nested transition groups</title>
<style>
  #panel {
    view-transition-name: panel;
    view-transition-group: contain;
    width: 240px;
    padding: 16px;
    background: #ddd;
  }
  #tile {
    view-transition-name: tile;
    width: 48px;
    height: 48px;
    background: #165dcc;
  }
  #panel.moved #tile { transform: translateX(160px); }
  ::view-transition-group(*) { animation-duration: 1s; }
  @media (prefers-reduced-motion: reduce) {
    ::view-transition-group(*),
    ::view-transition-old(*),
    ::view-transition-new(*) { animation-duration: 0s; }
  }
</style>
<button id="toggle" type="button">Toggle</button>
<div id="panel"><div id="tile"></div></div>
<p id="status" role="status">Ready</p>
<script>
  const panel = document.querySelector('#panel');
  const button = document.querySelector('#toggle');
  const status = document.querySelector('#status');
  button.addEventListener('click', async () => {
    button.disabled = true;
    const update = () => panel.classList.toggle('moved');
    try {
      if (document.startViewTransition &&
          CSS.supports('view-transition-group', 'contain')) {
        const transition = document.startViewTransition(update);
        await transition.finished;
        status.textContent = 'Finished';
      } else {
        update();
        status.textContent = 'Fallback';
      }
    } finally {
      button.disabled = false;
    }
  });
</script>
</html>

Resultado

Initially: Ready. First click moves the blue square 160px right; the next click returns it. After completion: Finished on the supported path, otherwise Fallback.

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