Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

onbeforeunload — obsluha události před opuštěním stránky

Atribut onbeforeunload na body nastavuje obslužnou funkci pro událost beforeunload objektu Window. Může požádat o upozornění před opuštěním stránky, ale nezaručuje zobrazení dialogu ani zrušení navigace.

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

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

onbeforeunload je atribut obsluhy události na body. Jeho hodnotou je kód JavaScriptu, nikoli název události nebo logická hodnota. Obsluhuje událost beforeunload objektu Window, ne událost cílenou na samotné body. Odpovídající vlastnost JavaScriptu je window.onbeforeunload.

Při skutečném opouštění stránky může obslužná funkce zavolat event.preventDefault() a požádat o potvrzení. Starší mechanismus nastavuje event.returnValue na neprázdný řetězec. Zvláštní pravidlo pro onbeforeunload také dovoluje vrátit hodnotu jinou než null a undefined, čímž se událost zruší; nepřenášejte sem obvyklý vzor return false. Návratová hodnota funkce předané do addEventListener() takto nefunguje.

Zrušení události nezaručuje zastavení navigace: prohlížeč rozhoduje, zda zobrazí potvrzení, a uživatel se může rozhodnout odejít. Dialog vyžaduje předchozí aktivaci uživatelem a prohlížeč jej může kvůli svým omezením potlačit. Vlastní text upozornění nastavit nelze. Obslužnou funkci zapínejte jen při neuložených změnách a po uložení ji odstraňte; nepovažujte ji za zaručený mechanismus ukládání dat.

Příklad odešle na window syntetickou, zrušitelnou událost a ověří event.defaultPrevented. Očekávaný výstup je true. Netestuje skutečnou navigaci ani dialog; následně odstraní atribut, aby nezůstal aktivní žádný obslužný prvek.

Pří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ýsledek

true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje