Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

onhashchange — spracovanie zmien fragmentu URL

Atribút onhashchange na body určuje JavaScriptový kód, ktorý spracúva udalosť hashchange objektu Window. Umožňuje stránke reagovať na navigáciu v rámci toho istého dokumentu, keď sa zmení fragment URL, teda časť za znakom #.

Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<body onhashchange="JavaScript statements">

onhashchange je atribút obsluhy udalosti na body, nie globálny atribút pre ľubovoľné prvky HTML. Jeho hodnota obsahuje príkazy JavaScriptu. Hoci je zapísaný na body, spracúva udalosť hashchange objektu Window, nie udalosť zacielenú na samotný prvok.

Udalosť sa vyvolá pri navigácii v rámci toho istého dokumentu, ktorá zmení fragment URL, napríklad pri prechode cez odkaz s fragmentom alebo pri priradení inej hodnoty do location.hash. Objekt event je HashChangeEvent: event.oldURL a event.newURL obsahujú úplné URL pred zmenou a po nej. Samotné načítanie stránky s počiatočným fragmentom nie je zmenou fragmentu.

history.pushState() a history.replaceState() udalosť hashchange nevyvolajú, ani keď zmenia fragment. V príklade teda history.replaceState() nastaví východiskový bod bez spustenia obsluhy. Po jednom kliknutí by mal byť výsledok #start -> #finish; opätovné kliknutie na ten istý odkaz fragment nezmení.

V JavaScripte sprístupňuje rovnaký mechanizmus obsluhy window.onhashchange. Priradenie novej funkcie nahradí predchádzajúcu obsluhu na tomto mieste; window.addEventListener('hashchange', handler) umožňuje registrovať nezávislé poslucháče bez takéhoto nahradenia.

Prí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ýsledok

#start -> #finish

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje