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é
viewTransitiondes objets d'évènementpagerevealetpageswapdans 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.
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
| Specification |
|---|
| CSS View Transitions Module Level 2 # dom-document-activeviewtransition |
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