CKTIS / HTML
onhashchange — wijzigingen van het URL-fragment afhandelen
Het onhashchange-attribuut op body geeft JavaScript-code op die de hashchange-gebeurtenis van het Window-object afhandelt. Zo kan een pagina reageren op navigatie binnen hetzelfde document wanneer het URL-fragment, het gedeelte na #, verandert.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onhashchange="JavaScript statements">onhashchange is een gebeurtenisafhandelingsattribuut van body, geen globaal attribuut voor willekeurige HTML-elementen. De waarde bevat JavaScript-instructies. Hoewel het op body staat, handelt het de hashchange-gebeurtenis van het Window-object af, niet een gebeurtenis die op het element zelf is gericht.
De gebeurtenis wordt geactiveerd bij navigatie binnen hetzelfde document die het URL-fragment verandert, bijvoorbeeld door een fragmentkoppeling te volgen of een andere waarde aan location.hash toe te wijzen. Het event-object is een HashChangeEvent: event.oldURL en event.newURL bevatten de volledige URL's vóór en na de wijziging. Alleen een pagina laden met een aanvankelijk fragment geldt niet als een fragmentwijziging.
history.pushState() en history.replaceState() activeren hashchange niet, zelfs niet wanneer ze het fragment veranderen. In het voorbeeld stelt history.replaceState() daarom het beginpunt in zonder de handler uit te voeren. Na één klik hoort het resultaat #start -> #finish te zijn; nogmaals op dezelfde koppeling klikken verandert het fragment niet.
In JavaScript biedt window.onhashchange hetzelfde handlermechanisme. Een nieuwe functie toewijzen vervangt de vorige handler op die plek; met window.addEventListener('hashchange', handler) kun je onafhankelijke listeners registreren zonder die vervanging.
Voorbeelden
<!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>Resultaat
#start -> #finish
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.