CKTIS / HTML
onhashchange — Änderungen des URL-Fragments behandeln
Das Attribut onhashchange auf body legt JavaScript-Code fest, der das hashchange-Ereignis des Window-Objekts behandelt. Damit kann eine Seite auf Navigation innerhalb desselben Dokuments reagieren, wenn sich das URL-Fragment ändert, also der Teil nach #.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onhashchange="JavaScript statements">onhashchange ist ein Ereignisbehandlungsattribut auf body, kein globales Attribut für beliebige HTML-Elemente. Sein Wert enthält JavaScript-Anweisungen. Obwohl es auf body steht, behandelt es das hashchange-Ereignis des Window-Objekts und kein Ereignis, das an das Element selbst gerichtet ist.
Das Ereignis wird bei einer Navigation innerhalb desselben Dokuments ausgelöst, die das URL-Fragment ändert, etwa beim Folgen eines Fragment-Links oder beim Zuweisen eines anderen Werts zu location.hash. Das event-Objekt ist ein HashChangeEvent: event.oldURL und event.newURL enthalten die vollständigen URLs vor und nach der Änderung. Das bloße Laden einer Seite mit einem anfänglichen Fragment ist keine Fragmentänderung.
history.pushState() und history.replaceState() lösen hashchange nicht aus, selbst wenn sie das Fragment ändern. Im Beispiel legt history.replaceState() daher den Ausgangspunkt fest, ohne den Handler auszuführen. Nach einem Klick sollte das Ergebnis #start -> #finish lauten; ein erneuter Klick auf denselben Link ändert das Fragment nicht.
In JavaScript stellt window.onhashchange denselben Handler-Mechanismus bereit. Eine neu zugewiesene Funktion ersetzt den vorherigen Handler an dieser Stelle; mit window.addEventListener('hashchange', handler) lassen sich unabhängige Listener registrieren, ohne ihn zu ersetzen.
Beispiele
<!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>Ergebnis
#start -> #finish
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.