PopStateEvent : propriété hasUAVisualTransition
Baseline 2026
Nouvellement disponible
Depuis mars 2026, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.
La propriété en lecture seule hasUAVisualTransition de l'interface PopStateEvent retourne true si l'agent utilisateur a effectué une transition visuelle pour cette navigation avant de déclencher cet évènement, ou sinon false.
Les agents utilisateurs peuvent fournir une transition visuelle intégrée lors de l'exécution des navigations sur le site. Si l'auteur·ice du site ajoute également une transition visuelle, les transitions de l'agent utilisateur et de l'auteur·ice peuvent entrer en conflit et perturber un·e visiteur·euse. La propriété permet de détecter si une transition de l'agent utilisateur a été fournie afin de pouvoir ignorer les transitions de l'auteur·ice pour une meilleure expérience utilisateur·ice.
Valeur
Une valeur booléenne.
Exemples
window.addEventListener("popstate", async (event) => {
// Récupère le nouveau contenu
const newContent = await fetchNewContent(location.href);
// L'agent utilisateur ne prend pas en charge les transitions de vue,
// ou l'agent utilisateur a déjà fourni une transition visuelle par
// lui-même (par exemple, retour par balayage).
// Dans les deux cas, met à jour le DOM directement
if (!document.startViewTransition || event.hasUAVisualTransition) {
doSinglePageAppNav(newContent);
return;
}
// Met à jour le contenu en utilisant une transition de vue
document.startViewTransition(() => {
doSinglePageAppNav(newContent);
});
});
Spécifications
| Spécification |
|---|
| HTML # dom-popstateevent-hasuavisualtransition |