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

CKTIS / CSS

view-transition-class — estilos partilhados para transições de vista

A propriedade view-transition-class atribui etiquetas que permitem partilhar estilos entre pseudo-elementos de transição de vista com nomes diferentes.

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

Sintaxe

view-transition-class: none | <custom-ident>+;

view-transition-class aceita none ou identificadores separados por espaços. O valor inicial é none, não é herdada e o seu tipo de animação é discreto. Não altera o atributo HTML class.

Por si só, não ativa a captura de elementos: serve para definir estilos, enquanto view-transition-name identifica um participante na transição e associa os seus estados antigo e novo. As classes partilhadas não exigem nomes partilhados.

O seletor ::view-transition-group(*.tile) seleciona grupos com a classe tile. O mesmo mecanismo funciona com ::view-transition-image-pair(), ::view-transition-old() e ::view-transition-new(). Se o seletor contiver várias classes, todas têm de corresponder; não as separes com espaços.

none não pode ser combinado com identificadores. Se um nome aparecer nos dois estados, aplicam-se as classes do estado novo. A especificação é um rascunho; o exemplo requer verificação local.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>view-transition-class</title>
<style>
  .box {
    view-transition-class: tile;
    width: 60px;
    height: 60px;
    margin: 8px;
    background: teal;
  }
  #a { view-transition-name: box-a; }
  #b { view-transition-name: box-b; }
  .moved .box { transform: translateX(120px); }
  ::view-transition-group(*.tile) { animation-duration: 1s; }
  @media (prefers-reduced-motion: reduce) {
    ::view-transition-group(*.tile) { animation-duration: 0s; }
  }
</style>
<button id="move">Move</button>
<div id="a" class="box"></div>
<div id="b" class="box"></div>
<script>
  const button = document.querySelector('#move');
  button.onclick = async () => {
    const update = () => document.body.classList.toggle('moved');
    if (!document.startViewTransition ||
        !CSS.supports('view-transition-class', 'tile') ||
        !CSS.supports('selector(::view-transition-group(*.tile))')) {
      update();
      return;
    }
    button.disabled = true;
    try {
      await document.startViewTransition(update).finished;
    } finally {
      button.disabled = false;
    }
  };
</script>

Resultado

Clicking Move toggles both teal boxes between their original positions and positions 120px to the right. With the required support, their transition groups use a 1s animation duration; reduced-motion preference changes that duration to 0s. The fallback updates positions immediately.

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