CKTIS / HTML
onbeforeunload — spracovanie udalosti pred opustením stránky
Atribút onbeforeunload na body nastavuje obslužnú funkciu pre udalosť beforeunload objektu Window. Môže požiadať o upozornenie pred opustením stránky, no nezaručuje zobrazenie dialógu ani zrušenie navigácie.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onbeforeunload="event.preventDefault()">onbeforeunload je atribút obsluhy udalosti na body. Jeho hodnotou je kód JavaScriptu, nie názov udalosti ani logická hodnota. Spracúva udalosť beforeunload objektu Window, nie udalosť zacielenú na samotné body. Zodpovedajúca vlastnosť JavaScriptu je window.onbeforeunload.
Pri skutočnom opúšťaní stránky môže obslužná funkcia zavolať event.preventDefault() a požiadať o potvrdenie. Starší mechanizmus nastavuje event.returnValue na neprázdny reťazec. Osobitné pravidlo pre onbeforeunload umožňuje aj vrátiť hodnotu inú než null a undefined, čím sa udalosť zruší; neprenášajte sem bežný vzor return false. Návratová hodnota funkcie odovzdanej do addEventListener() takto nefunguje.
Zrušenie udalosti nezaručuje zastavenie navigácie: prehliadač rozhodne, či zobrazí potvrdenie, a používateľ sa môže rozhodnúť odísť. Dialóg vyžaduje predchádzajúcu aktiváciu používateľom a prehliadač ho môže pre svoje obmedzenia potlačiť. Vlastný text upozornenia sa nastaviť nedá. Obslužnú funkciu zapínajte len pri neuložených zmenách a po uložení ju odstráňte; nepovažujte ju za zaručený mechanizmus ukladania údajov.
Príklad odošle na window syntetickú, zrušiteľnú udalosť a skontroluje event.defaultPrevented. Očakávaný výstup je true. Netestuje skutočnú navigáciu ani dialóg; potom odstráni atribút, aby nezostala aktívna obslužná funkcia.
Príklady
<!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>Výsledok
true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.