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

CKTIS / CSS

::view-transition-group() — groupe de transition de vue

Le pseudo-élément ::view-transition-group() représente un groupe de transition de vue nommé. Il permet de contrôler l’animation de sa géométrie et la durée d’animation des images de ses états ancien et nouveau.

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

Syntaxe

::view-transition-group(<pt-name-and-class-selector>)
<pt-name-and-class-selector> = <pt-name-selector> <pt-class-selector>? | <pt-class-selector>
<pt-name-selector> = '*' | <custom-ident>
<pt-class-selector> = ['.' <custom-ident>]+

::view-transition-group(card) sélectionne le groupe généré pour le nom card, attribué par view-transition-name. Il ne sélectionne pas un élément DOM. Le groupe contient ::view-transition-image-pair(card), qui renferme les images de l’ancien et du nouvel état. Lorsque les deux états existent, le navigateur anime par défaut la taille et la transformation du groupe entre eux.

L’argument * sélectionne tous les groupes ; root est le nom de transition par défaut de l’élément du document. Le niveau 2 ajoute des sélecteurs de classe, comme ::view-transition-group(.tile) et ::view-transition-group(card.tile), associés à view-transition-class et non à l’attribut HTML class. Les espaces sont interdits entre les composants de l’argument. () vide est invalide.

Appliquez le sélecteur directement à l’élément racine de la transition, par exemple :root::view-transition-group(card) pour une transition de document ; ne l’enchaînez pas sous la forme ::view-transition::view-transition-group(card). Définir animation-duration sur le groupe contrôle aussi par défaut la durée d’animation de ses descendants. Ne confondez pas ce pseudo-élément avec la propriété view-transition-group, qui contrôle l’imbrication des groupes.

L’exemple déclenche une mise à jour avec document.startViewTransition(), réduit les mouvements selon prefers-reduced-motion et effectue la mise à jour sans transition si la fonctionnalité n’est pas prise en charge. Le niveau 2 est un brouillon ; vérifiez les fonctionnalités utilisées dans le navigateur cible, indépendamment du contrôle de périmètre Chromium 152.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>View transition group</title>
<style>
  :root { view-transition-name: none; }
  #card {
    view-transition-name: card;
    width: 100px;
    height: 80px;
    background: royalblue;
    margin-top: 16px;
  }
  #card.moved { transform: translateX(160px); }
  ::view-transition-group(card) {
    animation-duration: 1s;
    animation-timing-function: linear;
  }
  @media (prefers-reduced-motion: reduce) {
    ::view-transition-group(card) { animation-duration: 0s; }
  }
</style>
<button id="move" type="button">Move</button>
<p id="status" role="status">Ready</p>
<div id="card"></div>
<script>
  const button = document.querySelector('#move');
  const card = document.querySelector('#card');
  const status = document.querySelector('#status');
  button.addEventListener('click', async () => {
    button.disabled = true;
    const update = () => card.classList.toggle('moved');
    try {
      if (document.startViewTransition &&
          CSS.supports('selector(::view-transition-group(card))')) {
        const transition = document.startViewTransition(update);
        await transition.finished;
        status.textContent = 'Finished';
      } else {
        update();
        status.textContent = 'Updated without transition';
      }
    } finally {
      button.disabled = false;
    }
  });
</script>
</html>

Résultat

First click: the blue box ends 160 CSS pixels to the right. With an active supported transition and no reduced-motion preference, movement takes approximately 1 second and the status becomes "Finished". Without support, the box updates immediately and the status becomes "Updated without transition". The next click returns it.

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