Document : propriété activeViewTransition

La propriété en lecture seule activeViewTransition de l'interface Document retourne une instance de ViewTransition représentant une transition de vue actuellement active sur le document.

La transition de vue (ViewTransition) peut être accédée de différentes manières :

La valeur de retour de Document.startViewTransition() dans le cas des transitions de vue au sein du même document.
La propriété viewTransition des objets d'évènement pagereveal et pageswap dans le cas des transitions de vue entre documents.

Cependant, la propriété activeViewTransition fournit un moyen cohérent d'accéder à la transition de vue active dans n'importe quel contexte, sans avoir à se soucier de la sauvegarder pour y accéder facilement plus tard.

Dans cet article

Valeur

Un objet ViewTransition ou null s'il n'y a pas de transition de vue active.

Exemples

js
// Démarrer une transition de vue
document.startViewTransition(() => {
  // Mettre à jour l'interface utilisateur pour refléter le nouvel état
  updateUI();
});

// Vérifier si une transition de vue est actuellement active
if (document.activeViewTransition) {
  console.log("Une transition de vue est actuellement active");
}

// Réagir à la fin de la transition de vue
document.activeViewTransition.finished.then(() => {
  console.log("Transition de vue terminée");
});

Spécifications

Spécification

CSS View Transitions Module Level 2
# dom-document-activeviewtransition

Compatibilité des navigateurs

Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.

Voir aussi

La méthode Document.startViewTransition()
L'évènement pagereveal
L'évènement pageswap
L'API View Transition
L'interface ViewTransition

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 7 mars 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

Référence du DOM
Document
Constructeur
1. Document()
Propriétés d'instance
Méthodes statiques
1. parseHTML()
2. parseHTMLUnsafe()
Méthodes d'instance
Évènements
Héritage
1. Node
2. EventTarget
Pages liées à DOM
Guides
1. Anatomy of the DOM
2. Réflexion des attributs
3. Sélection et parcours de l'arbre DOM
4. Construire et mettre à jour l'arbre DOM
5. Travailler avec des évènements