Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

onhashchange — obravnavanje sprememb fragmenta URL-ja

Atribut onhashchange na body določa kodo JavaScript, ki obravnava dogodek hashchange predmeta Window. Stran se lahko tako odzove na krmarjenje znotraj istega dokumenta, ko se spremeni fragment URL-ja, torej del za znakom #.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

<body onhashchange="JavaScript statements">

onhashchange je atribut za obravnavo dogodkov na body, ne pa globalni atribut za poljubne elemente HTML. Njegova vrednost vsebuje stavke JavaScript. Čeprav je zapisan na body, obravnava dogodek hashchange predmeta Window, ne pa dogodka, ki bi bil namenjen samemu elementu.

Dogodek se sproži pri krmarjenju znotraj istega dokumenta, ki spremeni fragment URL-ja, na primer ob sledenju povezavi s fragmentom ali dodelitvi druge vrednosti location.hash. Predmet event je HashChangeEvent: event.oldURL in event.newURL vsebujeta celotna URL-ja pred spremembo in po njej. Samo nalaganje strani z začetnim fragmentom ne pomeni spremembe fragmenta.

history.pushState() in history.replaceState() ne sprožita dogodka hashchange, tudi če spremenita fragment. V primeru zato history.replaceState() nastavi začetno točko, ne da bi zagnal obravnavo. Po enem kliku bi moral biti rezultat #start -> #finish; ponovni klik na isto povezavo fragmenta ne spremeni.

V JavaScriptu isti mehanizem obravnave omogoča window.onhashchange. Dodelitev nove funkcije nadomesti prejšnjo obravnavo na tem mestu; window.addEventListener('hashchange', handler) omogoča registracijo neodvisnih poslušalcev brez takšne zamenjave.

Primeri

<!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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri