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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.