Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

::view-transition — racine de l’arbre de transition de vue

Le pseudo-élément ::view-transition est la racine stylisable d’un arbre de transition de vue. Il permet d’appliquer des effets à l’ensemble de l’arbre de transition plutôt que de styliser séparément les images de l’ancien et du nouvel état.

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

Syntaxe

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

::view-transition sélectionne la racine, générée par le navigateur, d’un arbre de pseudo-éléments de transition de vue. Il ne prend aucun argument : ::view-transition(root) est invalide. Il ne génère des boîtes que s’il a des enfants.

En dessous se trouvent les groupes ::view-transition-group() contenant des paires d’images, ainsi que ::view-transition-old() et ::view-transition-new(). Un effet appliqué à la racine, comme filter, affecte tout l’arbre. Le sélecteur ne démarre pas une transition ; dans l’exemple, c’est document.startViewTransition() qui s’en charge.

Lors d’une transition portant sur tout le document, la couche de transition est peinte au-dessus du reste du contenu, y compris au-dessus de la top layer. Le brouillon de niveau 2 décrit aussi les transitions limitées à un élément ; ne déduisez pas leur prise en charge de celle des transitions de document. @view-transition est une règle distincte qui active les transitions entre documents, et non ce pseudo-élément.

Dans l’exemple, le filtre retire temporairement les couleurs de la superposition de transition, et non du contenu permanent de la page. Sans l’API, le texte change tout de même. La préférence de réduction des animations ramène la durée de l’animation à zéro. Une vérification locale est nécessaire ; un brouillon de spécification ne confirme pas la prise en charge dans une version donnée du navigateur.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>View transition root</title>
<style>
  body { font: 1.25rem sans-serif; }
  ::view-transition { filter: grayscale(1); }
  ::view-transition-group(root) { animation-duration: 1s; }
  @media (prefers-reduced-motion: reduce) {
    ::view-transition-group(root) { animation-duration: 0s; }
  }
  #state { color: #b00020; }
</style>
<button id="change" type="button">Change</button>
<p id="state">Before</p>
<script>
  const button = document.querySelector('#change');
  const state = document.querySelector('#state');
  button.addEventListener('click', async () => {
    button.disabled = true;
    const update = () => { state.textContent = 'After'; };
    if (typeof document.startViewTransition !== 'function') {
      update();
      return;
    }
    const transition = document.startViewTransition(update);
    await transition.finished;
  });
</script>

Résultat

Initially: Before. After clicking Change: After; the button remains disabled. If the visual transition runs, its overlay is grayscale during the transition; afterward, After is red.

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources