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

CKTIS / HTML

onbeforeunload — обработване на събитие преди напускане на страница

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

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

Синтаксис

<body onbeforeunload="event.preventDefault()">

onbeforeunload е атрибут за обработчик на събитие върху body. Стойността му е JavaScript код, а не име на събитие или булева стойност. Той обработва събитието beforeunload на обекта Window, а не събитие, насочено към самия body. Съответното JavaScript свойство е window.onbeforeunload.

При действително напускане на страница обработчикът може да извика event.preventDefault(), за да поиска потвърждение. По-стар механизъм задава на event.returnValue непразен низ. Специално правило за onbeforeunload позволява и връщането на стойност, различна от null и undefined, за да се отмени събитието; не пренасяйте тук обичайния шаблон return false. Върнатата стойност на функция, подадена на addEventListener(), не действа по този начин.

Отмяната на събитието не гарантира спиране на навигацията: браузърът решава дали да покаже потвърждение, а потребителят може да избере да напусне. Диалоговият прозорец изисква предварително активиране от потребителя и може да бъде потиснат заради ограниченията на браузъра. Не може да зададете собствен текст за предупреждението. Включвайте обработчика само при незаписани промени и го премахвайте след записване; не го смятайте за гарантиран механизъм за запазване на данни.

Примерът изпраща към window синтетично събитие, което може да бъде отменено, и проверява event.defaultPrevented. Очакваният резултат е true. Той не проверява реална навигация или диалогов прозорец; след това премахва атрибута, за да не остане активен обработчик.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>onbeforeunload wiring test</title>
</head>
<body onbeforeunload="event.preventDefault()">
  <p>See the browser console.</p>
  <script>
    const event = new Event('beforeunload', { cancelable: true });
    window.dispatchEvent(event);
    console.log(event.defaultPrevented);
    document.body.removeAttribute('onbeforeunload');
  </script>
</body>
</html>

Резултат

true

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

Източници