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

CKTIS / CSS

:active-view-transition — uma transição de vista ativa

A pseudoclasse :active-view-transition seleciona o elemento que define o âmbito de uma transição de vista ativa: o elemento raiz, se a transição abranger todo o documento, ou o elemento a que a transição se limita. Permite que os estilos dependam desse estado sem verificar o tipo de transição.

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

Sintaxe

:active-view-transition { /* declarations */ }

:active-view-transition corresponde ao elemento que define o âmbito de uma transição de vista ativa. Se a transição abranger todo o documento, corresponde ao elemento raiz do documento. Se estiver limitada a um elemento, corresponde a esse elemento. A pseudoclasse não seleciona todos os elementos animados nem inicia uma transição por si só.

Não aceita argumentos. A sua especificidade é (0,1,0); escrever :root:active-view-transition acrescenta a especificidade de :root. Ao contrário de :active-view-transition-type(), não verifica o tipo de transição. Não a confunda com o pseudo-elemento ::view-transition, que representa a camada visual da transição.

O exemplo usa uma transição cujo âmbito é todo o documento e verifica se o elemento raiz corresponde ao seletor em três momentos: antes da chamada a document.startViewTransition(), imediatamente após essa chamada e imediatamente após a chamada a skipTransition(). Não espera que as promessas ready ou finished sejam cumpridas ou rejeitadas. «Ativa» refere-se ao estado da transição, não à presença geral de animações CSS. Level 2 é um rascunho de especificação; verifique separadamente o suporte do seletor e da API.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Match an active view transition</title>
  <style>
    :root:active-view-transition #state { color: teal; }
  </style>
</head>
<body>
  <main><p id="state">Before update</p></main>
  <script>
    (() => {
      const selector = ':active-view-transition';
      if (!CSS.supports(`selector(${selector})`) ||
          typeof document.startViewTransition !== 'function') {
        console.log('Active view transition selector: unsupported');
        return;
      }
      const root = document.documentElement;
      const state = document.getElementById('state');
      const before = root.matches(selector);
      const transition = document.startViewTransition(() => {
        state.textContent = 'After update';
      });
      // Skipping rejects ready; this test checks selector state, not rendering.
      transition.ready.catch(() => {});
      const active = root.matches(selector);
      transition.skipTransition();
      const after = root.matches(selector);
      console.log(`Active view transition selector: supported\nBefore: ${before}\nActive: ${active}\nAfter skip: ${after}`);
    })();
  </script>
</body>
</html>

Resultado

Active view transition selector: supported
Before: false
Active: true
After skip: false

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