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

CKTIS / CSS

::view-transition-image-pair() — conteneur de la paire d’images de transition

Le pseudo-élément ::view-transition-image-pair() regroupe les images correspondantes de l’ancien et du nouvel état pendant une transition de vue. Il permet de découper ces images ensemble et de contrôler l’isolation de leur fusion.

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

Syntaxe

::view-transition-image-pair(<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-image-pair() est un conteneur généré à l’intérieur de son ::view-transition-group() correspondant. Il contient ::view-transition-old(), ::view-transition-new() ou les deux, dans cet ordre. Ce n’est pas un élément DOM ordinaire : il représente les images de transition, et non l’élément source lui-même.

L’argument card correspond au nom défini par view-transition-name: card, tandis que * correspond à tous les noms. Le niveau 2 autorise aussi les classes view-transition-class, par exemple ::view-transition-image-pair(.tile) ou ::view-transition-image-pair(card.tile). Les espaces sont interdits entre le nom et les classes, ainsi qu’entre les composants de classe. () vide n’est pas un sélecteur valide.

Les styles de transition par défaut appliquent isolation: isolate au conteneur uniquement lorsque les images de l’ancien et du nouvel état sont toutes deux présentes. Cela empêche ces images de se mélanger au contenu situé hors de la paire. En général, on applique les styles au groupe ou aux images individuellement ; ce conteneur est utile pour les découper ensemble. Dans l’exemple, les coins arrondis n’existent que pendant la transition, car la règle ne modifie pas #card.

Le document de niveau 2 est un brouillon, pas une garantie de prise en charge. Vérifiez l’exemple dans le navigateur cible ; la disponibilité de document.startViewTransition ne prouve pas la prise en charge de toutes les variantes du sélecteur.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Image pair clipping</title>
<style>
  :root { view-transition-name: none; }
  #card {
    view-transition-name: card;
    width: 180px;
    padding: 32px;
    background: navy;
    color: white;
  }
  #card.changed { background: maroon; }
  ::view-transition-group(card) { animation-duration: 2s; }
  ::view-transition-image-pair(card) {
    border-radius: 32px;
    overflow: clip;
  }
</style>
<button id="change" type="button">Change</button>
<p id="card">Before</p>
<script>
  const button = document.querySelector('#change');
  const card = document.querySelector('#card');
  button.addEventListener('click', async () => {
    button.disabled = true;
    const update = () => {
      card.classList.add('changed');
      card.textContent = 'After';
    };
    if (!document.startViewTransition) {
      update();
      return;
    }
    const transition = document.startViewTransition(update);
    await transition.finished;
  });
</script>
</html>

Résultat

Before → After

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