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

CKTIS / CSS

view-transition-group — imbrication des groupes de transition

La propriété view-transition-group définit la hiérarchie des groupes nommés pendant une transition de vue, indépendamment de la disposition du DOM.

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

Syntaxe

view-transition-group: normal | contain | nearest | <custom-ident>;

view-transition-group contrôle l’imbrication de ::view-transition-group() ; elle ne nomme pas une transition. Elle nécessite une valeur de view-transition-name différente de none.

La valeur initiale normal utilise le groupe conteneur établi par l’ancêtre participant le plus proche dans l’arbre plat pour lequel view-transition-group vaut contain. C’est contain qui fixe la limite de groupement pour les descendants. nearest sélectionne l’ancêtre participant le plus proche, quelle que soit la valeur de cette propriété sur cet ancêtre.

<custom-ident> cible un ancêtre au moyen de view-transition-name. En l’absence de correspondance, l’algorithme du brouillon utilise le groupe conteneur ; la description de la valeur suggère plutôt la racine directe — le brouillon est incohérent. L’imbrication utilise ::view-transition-group-children().

La propriété n’est pas héritée ; l’animation est discrète. Ne la confondez pas avec le pseudo-élément ::view-transition-group(). Il s’agit d’une fonctionnalité d’un brouillon de spécification : vérifiez son comportement dans le navigateur cible.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Nested transition groups</title>
<style>
  #panel {
    view-transition-name: panel;
    view-transition-group: contain;
    width: 240px;
    padding: 16px;
    background: #ddd;
  }
  #tile {
    view-transition-name: tile;
    width: 48px;
    height: 48px;
    background: #165dcc;
  }
  #panel.moved #tile { transform: translateX(160px); }
  ::view-transition-group(*) { animation-duration: 1s; }
  @media (prefers-reduced-motion: reduce) {
    ::view-transition-group(*),
    ::view-transition-old(*),
    ::view-transition-new(*) { animation-duration: 0s; }
  }
</style>
<button id="toggle" type="button">Toggle</button>
<div id="panel"><div id="tile"></div></div>
<p id="status" role="status">Ready</p>
<script>
  const panel = document.querySelector('#panel');
  const button = document.querySelector('#toggle');
  const status = document.querySelector('#status');
  button.addEventListener('click', async () => {
    button.disabled = true;
    const update = () => panel.classList.toggle('moved');
    try {
      if (document.startViewTransition &&
          CSS.supports('view-transition-group', 'contain')) {
        const transition = document.startViewTransition(update);
        await transition.finished;
        status.textContent = 'Finished';
      } else {
        update();
        status.textContent = 'Fallback';
      }
    } finally {
      button.disabled = false;
    }
  });
</script>
</html>

Résultat

Initially: Ready. First click moves the blue square 160px right; the next click returns it. After completion: Finished on the supported path, otherwise Fallback.

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