CKTIS / HTML
onhashchange — gérer les changements de fragment d’URL
L’attribut onhashchange de body définit le code JavaScript qui gère l’événement hashchange de l’objet Window. Il permet à une page de réagir à une navigation dans le même document lorsque le fragment de l’URL, la partie après #, change.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onhashchange="JavaScript statements">onhashchange est un attribut de gestion d’événement de body, et non un attribut global applicable à n’importe quel élément HTML. Sa valeur contient des instructions JavaScript. Bien qu’il soit écrit sur body, il gère l’événement hashchange de l’objet Window, et non un événement ciblant l’élément lui-même.
L’événement se déclenche lors d’une navigation dans le même document qui modifie le fragment de l’URL, par exemple en suivant un lien avec fragment ou en attribuant une autre valeur à location.hash. L’objet event est un HashChangeEvent : event.oldURL et event.newURL contiennent les URL complètes avant et après le changement. Le simple chargement d’une page avec un fragment initial ne constitue pas un changement de fragment.
history.pushState() et history.replaceState() ne déclenchent pas hashchange, même s’ils modifient le fragment. Dans l’exemple, history.replaceState() définit donc le point de départ sans exécuter le gestionnaire. Après un clic, le résultat doit être #start -> #finish ; cliquer de nouveau sur le même lien ne modifie pas le fragment.
En JavaScript, window.onhashchange expose le même mécanisme de gestionnaire. Attribuer une nouvelle fonction remplace le gestionnaire précédent à cet emplacement ; window.addEventListener('hashchange', handler) permet d’enregistrer des écouteurs indépendants sans ce remplacement.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>onhashchange demo</title>
</head>
<body onhashchange="document.getElementById('result').textContent = new URL(event.oldURL).hash + ' -> ' + new URL(event.newURL).hash">
<a href="#finish">Go to #finish</a>
<pre id="result">Ready</pre>
<script>
history.replaceState(null, '', '#start');
</script>
</body>
</html>Résultat
#start -> #finish
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.