CKTIS / HTML
onhashchange — tratar alterações do fragmento do URL
O atributo onhashchange de body especifica o código JavaScript que trata o evento hashchange do objeto Window. Permite que uma página reaja à navegação no mesmo documento quando o fragmento do URL, a parte após #, é alterado.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<body onhashchange="JavaScript statements">onhashchange é um atributo de tratamento de eventos de body, não um atributo global aplicável a elementos HTML arbitrários. O seu valor contém instruções JavaScript. Embora esteja escrito em body, trata o evento hashchange do objeto Window, e não um evento dirigido ao próprio elemento.
O evento é desencadeado por uma navegação no mesmo documento que altera o fragmento do URL, por exemplo, ao seguir uma ligação com fragmento ou ao atribuir um valor diferente a location.hash. O objeto event é um HashChangeEvent: event.oldURL e event.newURL contêm os URLs completos antes e depois da alteração. O simples carregamento de uma página com um fragmento inicial não constitui uma alteração do fragmento.
history.pushState() e history.replaceState() não desencadeiam hashchange, mesmo que alterem o fragmento. No exemplo, history.replaceState() define, por isso, o ponto de partida sem executar o handler. Após um clique, o resultado deverá ser #start -> #finish; clicar novamente na mesma ligação não altera o fragmento.
Em JavaScript, window.onhashchange disponibiliza o mesmo mecanismo de handler. Atribuir uma nova função substitui o handler anterior nesse espaço; window.addEventListener('hashchange', handler) permite registar listeners independentes sem essa substituição.
Exemplos
<!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>Resultado
#start -> #finish
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.