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

CKTIS / HTML

onunload — обработване на разтоварването на документ

Атрибутът onunload на елемента body задава обработчик за събитието unload на обекта Window, а не обработчик за самия елемент. Той не е надеждно място за запазване на данни и не е начин да се предотврати напускането на страница.

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

Синтаксис

<body onunload="/* JavaScript */">
window.onunload = handler;
window.onunload = null;

onunload е атрибут за обработчик на събития за unload. В елемента body стойността му съдържа JavaScript, който се изпълнява като обработчик върху свързания обект Window. Това не е обикновен глобален атрибут за произволни HTML елементи.

Неговият еквивалент в JavaScript е window.onunload, на който може да се присвои функция или null. Атрибутът body и това свойство управляват един и същ обработчик: следващо присвояване заменя предишната стойност, а null го премахва. В кода на атрибута параметърът event предоставя събитието.

unload се отнася до разтоварването на документ, но не приемайте, че се задейства при всяко напускане на страница. Алгоритъмът на стандарта го пропуска, когато документът се запазва за по-късно възстановяване от хронологията. Не разчитайте на него като на единствено място за запазване на важни данни или за приключване на асинхронна работа. За наблюдение на жизнения цикъл обмислете pagehide или visibilitychange според целта си.

Не бъркайте onunload с onbeforeunload: unload не може да бъде отменено, а return false нито спира навигацията, нито показва подкана за напускане на страницата. Примерът умишлено изпраща синтетично събитие, за да покаже връзката на атрибута с Window, без да затваря страницата; той не възпроизвежда действително разтоварване на документ.

Примери

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onunload demonstration</title>
<body onunload="document.getElementById('result').textContent = event.type">
<output id="result">pending</output>
<script>
  window.dispatchEvent(new Event('unload'));
  window.onunload = null;
</script>
</body>
</html>

Резултат

unload

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

Източници