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

CKTIS / CSS

view-transition-name — nommer un élément dans une transition de vue

La propriété view-transition-name désigne un élément à capturer indépendamment pendant une transition de vue. Des noms identiques associent ses anciens et nouveaux états visuels ; la déclaration seule ne lance pas de transition.

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

Syntaxe

view-transition-name: none | <custom-ident> | auto | match-element;

view-transition-name permet d’animer un élément capturé indépendamment du reste de la page. Sa valeur initiale est none ; la propriété n’est pas héritée. none désactive la capture indépendante, mais ne retire pas l’élément de l’image d’un ancêtre capturé.

Un identifiant personnalisé tel que card associe les anciens et nouveaux états visuels, même s’ils appartiennent à des nœuds DOM différents. Le nom doit être unique parmi les éléments capturés simultanément pendant la transition ; les doublons interrompent l’animation, mais pas la mise à jour du DOM elle-même. Personnalisez le groupe avec ::view-transition-group(card).

Le brouillon de niveau 2 décrit aussi match-element, qui génère un nom à partir de l’identité de l’élément, et auto, qui peut utiliser l’id de l’élément et génère sinon un nom. Ces mots-clés ne sont pas des identifiants personnalisés. Un brouillon de spécification ne garantit pas la prise en charge par les navigateurs.

L’exemple démarre une transition avec document.startViewTransition() et change la position de card. En l’absence de prise en charge, il effectue une mise à jour ordinaire. La requête média prefers-reduced-motion: reduce fixe la durée de l’animation à 0s uniquement pour le groupe card ; la transition par défaut du groupe root reste active.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>view-transition-name</title>
<style>
  #card {
    view-transition-name: card;
    width: 120px;
    padding: 16px;
    background: navy;
    color: white;
  }
  #card.moved { margin-left: 160px; }
  ::view-transition-group(card) { animation-duration: 600ms; }
  @media (prefers-reduced-motion: reduce) {
    ::view-transition-group(card) { animation-duration: 0s; }
  }
</style>
<button id="move" type="button">Move</button>
<div id="card">A</div>
<script>
  const button = document.querySelector('#move');
  const card = document.querySelector('#card');
  button.addEventListener('click', async () => {
    button.disabled = true;
    const update = () => card.classList.toggle('moved');
    try {
      if (document.startViewTransition &&
          CSS.supports('view-transition-name', 'card')) {
        const transition = document.startViewTransition(update);
        await transition.finished;
      } else {
        update();
      }
    } finally {
      button.disabled = false;
    }
  });
</script>

Résultat

After the first click: card.classList.contains('moved') === true. After the second completed click: false. With supported view transitions, the card changes position through its named transition group; otherwise it moves immediately.

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