Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onhashchange — gestire le modifiche del frammento URL

L’attributo onhashchange di body specifica il codice JavaScript che gestisce l’evento hashchange dell’oggetto Window. Consente a una pagina di reagire alla navigazione nello stesso documento quando cambia il frammento dell’URL, cioè la parte dopo #.

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

Sintassi

<body onhashchange="JavaScript statements">

onhashchange è un attributo gestore di eventi di body, non un attributo globale per qualsiasi elemento HTML. Il suo valore contiene istruzioni JavaScript. Anche se è scritto su body, gestisce l’evento hashchange dell’oggetto Window, non un evento rivolto all’elemento stesso.

L’evento viene attivato dalla navigazione nello stesso documento che modifica il frammento dell’URL, ad esempio seguendo un collegamento con frammento o assegnando un valore diverso a location.hash. L’oggetto event è un HashChangeEvent: event.oldURL e event.newURL contengono gli URL completi prima e dopo la modifica. Il semplice caricamento di una pagina con un frammento iniziale non è una modifica del frammento.

history.pushState() e history.replaceState() non attivano hashchange, anche se modificano il frammento. Nell’esempio, quindi, history.replaceState() imposta il punto di partenza senza eseguire il gestore. Dopo un clic, il risultato dovrebbe essere #start -> #finish; fare di nuovo clic sullo stesso collegamento non modifica il frammento.

In JavaScript, window.onhashchange espone lo stesso meccanismo di gestione. Assegnare una nuova funzione sostituisce il gestore precedente in quello spazio; window.addEventListener('hashchange', handler) permette di registrare listener indipendenti senza sostituirlo.

Esempi

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

Risultato

#start -> #finish

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti