База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

onhashchange — обработване на промени във фрагмента на URL адреса

Атрибутът onhashchange на body задава JavaScript код, който обработва събитието hashchange на обекта Window. Така страницата може да реагира на навигация в рамките на същия документ, когато се промени фрагментът на URL адреса — частта след #.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

<body onhashchange="JavaScript statements">

onhashchange е атрибут за обработчик на събитие на body, а не глобален атрибут за произволни HTML елементи. Стойността му съдържа JavaScript инструкции. Макар да е зададен на body, той обработва събитието hashchange на обекта Window, а не събитие, насочено към самия елемент.

Събитието се задейства при навигация в рамките на същия документ, която променя фрагмента на URL адреса, например при следване на връзка с фрагмент или задаване на друга стойност на location.hash. Обектът event е HashChangeEvent: event.oldURL и event.newURL съдържат пълните URL адреси преди и след промяната. Самото зареждане на страница с начален фрагмент не е промяна на фрагмента.

history.pushState() и history.replaceState() не задействат hashchange, дори когато променят фрагмента. Затова в примера history.replaceState() задава началната точка, без да изпълнява обработчика. След едно щракване резултатът трябва да е #start -> #finish; повторното щракване върху същата връзка не променя фрагмента.

В JavaScript същият механизъм за обработка е достъпен чрез window.onhashchange. Задаването на нова функция заменя предишния обработчик на това място; window.addEventListener('hashchange', handler) позволява регистриране на независими слушатели без такава замяна.

Примери

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

Резултат

#start -> #finish

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници