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.