Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes