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

CKTIS / CSS

::view-transition-old() — l’image de l’ancien état

Le pseudo-élément ::view-transition-old() représente une capture statique de l’état précédent pendant une transition de vue. Il permet d’animer l’image sortante indépendamment du nouvel état, sans appliquer de style à l’ancien élément DOM.

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

Syntaxe

::view-transition-old(<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-old(card) sélectionne la capture de l’ancien état associée à view-transition-name: card. C’est un élément remplacé et un enfant de ::view-transition-image-pair(card), pas l’ancien nœud DOM. En l’absence d’ancien état, ce pseudo-élément n’est pas créé ; ::view-transition-new() représente le nouvel état.

L’argument * sélectionne toutes ces captures, tandis que root est le nom de transition par défaut de l’élément racine du document. Le niveau 2 accepte aussi les classes issues de view-transition-class, par exemple ::view-transition-old(.tile) et ::view-transition-old(card.tile). Aucun espace n’est autorisé dans la partie nom et classes de l’argument ; il ne s’agit pas de classes HTML.

Par défaut, l’ancienne image disparaît en fondu. Une animation personnalisée peut remplacer cette animation ; object-fit et object-position contrôlent l’image comme pour les autres éléments remplacés. :only-child correspond à l’ancienne capture lorsqu’il n’existe aucune nouvelle capture correspondante.

L’exemple met à jour une carte avec document.startViewTransition() et anime l’opacité de l’ancienne image pendant 1200 ms. Sans l’API, le contenu est mis à jour immédiatement. Une vérification locale est nécessaire : la prise en charge de l’API ne garantit ni celle de chaque syntaxe de sélecteur ni l’exécution d’une animation.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>Old snapshot</title>
<style>
  html { view-transition-name: none; }
  #card {
    view-transition-name: card;
    width: 12rem;
    padding: 2rem;
    background: navy;
    color: white;
  }
  #card.changed { background: darkgreen; }
  ::view-transition-old(card) {
    z-index: 1;
    animation: leave 1200ms linear both;
  }
  ::view-transition-new(card) { animation: none; }
  @keyframes leave {
    from { opacity: 1; }
    to { opacity: 0; }
  }
</style>
<p id="card">Before</p>
<button id="run" type="button">Run</button>
<script>
  const card = document.querySelector('#card');
  const button = document.querySelector('#run');
  button.addEventListener('click', async () => {
    button.disabled = true;
    const update = () => {
      card.classList.add('changed');
      card.textContent = 'After';
    };
    if (typeof document.startViewTransition !== 'function') {
      update();
      return;
    }
    const transition = document.startViewTransition(update);
    await transition.finished;
  });
</script>

Résultat

Initial: navy card displaying Before. After Run: darkgreen card displaying After; the button stays disabled. If the view transition runs, the old capture fades from full opacity to transparent over 1200 ms, revealing the new capture beneath it. Without the API, the update is immediate.

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