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

CKTIS / CSS

@view-transition — transições entre documentos

@view-transition ativa transições visuais em navegações elegíveis entre documentos da mesma origem.

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

Sintaxe

@view-transition {
  navigation: auto | none;
  types: none | <custom-ident>+;
}

@view-transition contém descritores, não seletores. navigation: auto é necessário em ambos os documentos; o valor inicial none desativa a transição.

auto abrange navegações elegíveis da mesma origem sem redirecionamentos entre origens. Inclui a navegação pelo histórico, mas não recarregamentos nem navegação a partir da barra de endereço.

types, opcional, aceita none ou identificadores separados por espaços; estes não podem começar por -ua-. Os tipos aplicam-se localmente a cada documento.

A regra não desencadeia atualizações do DOM através de document.startViewTransition(). O navegador pode ignorar a animação; uma regra não suportada é ignorada.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Cross-document view transition opt-in</title>
  <style id="opt-in">
    @view-transition {
      navigation: auto;
    }
  </style>
</head>
<body>
  <h1>Cross-document view transition opt-in</h1>
  <p>Both documents must opt in for an eligible same-origin navigation to transition. This example checks the opt-in without navigating.</p>
  <script>
    const rule = document.getElementById('opt-in').sheet.cssRules[0];
    const supported = rule && /^@view-transition\s*\{/.test(rule.cssText)
      && /\bnavigation:\s*auto\s*;/.test(rule.cssText);
    console.log(supported
      ? '@view-transition supported: navigation: auto parsed'
      : '@view-transition opt-in unsupported');
  </script>
</body>
</html>

Resultado

@view-transition supported: navigation: auto parsed

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