CKTIS / HTML
onhashchange — obrada promjena fragmenta URL-a
Atribut onhashchange na body određuje JavaScript kod koji obrađuje događaj hashchange objekta Window. Omogućuje stranici da reagira na navigaciju unutar istog dokumenta kada se promijeni fragment URL-a, odnosno dio nakon znaka #.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<body onhashchange="JavaScript statements">onhashchange je atribut za obradu događaja na body, a ne globalni atribut za proizvoljne HTML elemente. Njegova vrijednost sadrži JavaScript naredbe. Iako je zapisan na body, obrađuje događaj hashchange objekta Window, a ne događaj usmjeren na sam element.
Događaj se pokreće pri navigaciji unutar istog dokumenta koja mijenja fragment URL-a, primjerice praćenjem poveznice s fragmentom ili dodjelom druge vrijednosti u location.hash. Objekt event jest HashChangeEvent: event.oldURL i event.newURL sadrže pune URL-ove prije promjene i nakon nje. Samo učitavanje stranice s početnim fragmentom nije promjena fragmenta.
history.pushState() i history.replaceState() ne pokreću hashchange, čak ni kada mijenjaju fragment. Zato u primjeru history.replaceState() postavlja početnu točku bez pokretanja rukovatelja. Nakon jednog klika rezultat bi trebao biti #start -> #finish; ponovni klik na istu poveznicu ne mijenja fragment.
U JavaScriptu isti mehanizam rukovatelja omogućuje window.onhashchange. Dodjela nove funkcije zamjenjuje prethodni rukovatelj na tom mjestu; window.addEventListener('hashchange', handler) omogućuje registraciju neovisnih slušatelja bez takve zamjene.
Primjeri
<!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>Rezultat
#start -> #finish
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.