CKTIS / HTML
onhashchange — zpracování změn fragmentu URL
Atribut onhashchange na body určuje JavaScriptový kód, který zpracovává událost hashchange objektu Window. Umožňuje stránce reagovat na navigaci v rámci stejného dokumentu, když se změní fragment URL, tedy část za znakem #.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onhashchange="JavaScript statements">onhashchange je atribut obsluhy události na body, nikoli globální atribut pro libovolné prvky HTML. Jeho hodnota obsahuje příkazy JavaScriptu. Přestože je zapsán na body, zpracovává událost hashchange objektu Window, nikoli událost zaměřenou na samotný prvek.
Událost se vyvolá při navigaci v rámci stejného dokumentu, která změní fragment URL, například při přechodu přes odkaz s fragmentem nebo při přiřazení jiné hodnoty do location.hash. Objekt event je HashChangeEvent: event.oldURL a event.newURL obsahují úplné URL před změnou a po ní. Pouhé načtení stránky s počátečním fragmentem není změnou fragmentu.
history.pushState() a history.replaceState() událost hashchange nevyvolávají, ani když fragment změní. V příkladu tedy history.replaceState() nastaví výchozí bod, aniž by spustil obsluhu. Po jednom kliknutí by měl být výsledek #start -> #finish; opětovné kliknutí na stejný odkaz fragment nezmění.
V JavaScriptu zpřístupňuje stejný mechanismus obsluhy window.onhashchange. Přiřazení nové funkce nahradí předchozí obsluhu na tomto místě; window.addEventListener('hashchange', handler) umožňuje registrovat nezávislé posluchače bez takového nahrazení.
Příklady
<!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>Výsledek
#start -> #finish
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.