Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori