Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onhashchange — obsługa zmiany fragmentu adresu URL

Atrybut onhashchange elementu body określa kod JavaScript obsługujący zdarzenie hashchange obiektu Window. Pozwala reagować na nawigację w obrębie tego samego dokumentu, gdy zmienia się fragment adresu URL, czyli część po znaku #.

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

Składnia

<body onhashchange="JavaScript statements">

onhashchange jest atrybutem obsługi zdarzenia elementu body, a nie atrybutem globalnym dowolnego elementu HTML. Jego wartość zawiera instrukcje JavaScript. Mimo umieszczenia na body obsługuje zdarzenie hashchange obiektu Window, nie zdarzenie samego elementu.

Zdarzenie jest zgłaszane przy nawigacji w tym samym dokumencie, która zmienia fragment URL, np. po kliknięciu odsyłacza z fragmentem lub przypisaniu innej wartości do location.hash. Obiekt event jest obiektem HashChangeEvent: event.oldURL i event.newURL zawierają pełne adresy przed zmianą i po niej. Samo początkowe wczytanie strony z fragmentem nie jest zmianą fragmentu.

history.pushState() i history.replaceState() nie wywołują hashchange, nawet jeśli zmieniają fragment. W przykładzie history.replaceState() ustawia więc punkt początkowy bez uruchamiania procedury obsługi. Po jednym kliknięciu wynik powinien wynosić #start -> #finish; ponowne kliknięcie tego samego odsyłacza nie zmienia fragmentu.

W JavaScript ten sam mechanizm udostępnia window.onhashchange. Przypisanie nowej funkcji zastępuje poprzednią procedurę w tym miejscu; window.addEventListener('hashchange', handler) pozwala rejestrować niezależne procedury bez takiego zastępowania.

Przykłady

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

Wynik

#start -> #finish

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła