CKTIS / HTML
onbeforeunload — een gebeurtenis afhandelen voordat je een pagina verlaat
Het attribuut onbeforeunload op body stelt een handler in voor de beforeunload-gebeurtenis van het Window-object. Het kan een waarschuwing aanvragen voordat de pagina wordt verlaten, maar garandeert noch een dialoogvenster noch het annuleren van de navigatie.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onbeforeunload="event.preventDefault()">onbeforeunload is een gebeurtenis-handlerattribuut op body. De waarde is JavaScript-code, geen gebeurtenisnaam of booleaanse waarde. Het handelt de beforeunload-gebeurtenis van het Window-object af, niet een gebeurtenis die op body zelf gericht is. De bijbehorende JavaScript-eigenschap is window.onbeforeunload.
Wanneer een pagina daadwerkelijk wordt verlaten, kan de handler event.preventDefault() aanroepen om bevestiging te vragen. Een verouderd mechanisme stelt event.returnValue in op een niet-lege tekenreeks. Een speciale regel voor onbeforeunload staat ook toe een waarde anders dan null en undefined terug te geven om de gebeurtenis te annuleren; gebruik hier niet het gebruikelijke patroon return false. De retourwaarde van een functie die aan addEventListener() wordt doorgegeven, werkt niet op deze manier.
Het annuleren van de gebeurtenis garandeert niet dat de navigatie stopt: de browser bepaalt of er een bevestiging wordt weergegeven en de gebruiker kan ervoor kiezen om weg te gaan. Voor een dialoogvenster is voorafgaande gebruikersactivering vereist; de browser kan het ook onderdrukken vanwege beperkingen. Je kunt geen eigen waarschuwingstekst instellen. Schakel de handler alleen in bij niet-opgeslagen wijzigingen en verwijder hem na het opslaan; beschouw hem niet als een gegarandeerd mechanisme om gegevens op te slaan.
Het voorbeeld verzendt een synthetische, annuleerbare gebeurtenis naar window en controleert event.defaultPrevented. De verwachte uitvoer is true. Het test geen echte navigatie of dialoogvenster en verwijdert daarna het attribuut zodat er geen actieve handler achterblijft.
Voorbeelden
<!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>Resultaat
true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.