Événement onbeforeunload
Exemple
Exécutez un JavaScript lorsque la page est sur le point d'être déchargée :
<body onbeforeunload="return myFunction()">
Définition et utilisation
L'événement onbeforeunload se produit lorsque le document est sur le point d'être déchargé.
Cet événement permet d'afficher un message dans une boîte de dialogue de confirmation pour indiquer à l'utilisateur s'il souhaite rester ou quitter la page en cours.
Le message par défaut qui apparaît dans la boîte de confirmation est différent selon les navigateurs. Cependant, le message standard est quelque chose comme "Etes-vous sûr de vouloir quitter cette page ?". Ce message ne peut pas être supprimé.
Cependant, vous pouvez écrire un message personnalisé avec le message par défaut. Voir le premier exemple sur cette page. Remarque : Cela ne fonctionne que dans Internet Explorer.
Remarque : Si l'événement onbeforeunload n'est pas affecté à l'élément <body>, vous devez affecter/attacher l'événement sur l'objet window et utiliser la propriété returnValue pour créer un message personnalisé (voir les exemples de syntaxe ci-dessous).
Prise en charge du navigateur
Les nombres dans le tableau indiquent la première version du navigateur qui prend entièrement en charge l'événement.
Event | |||||
---|---|---|---|---|---|
onbeforeunload | Yes | Yes | Yes | Yes | 15.0 |
Syntaxe
En HTML :
<element onbeforeunload="myScript">
En Javascript :
object.onbeforeunload = function(){myScript};
En JavaScript, en utilisant la méthode addEventListener() :
object.addEventListener("beforeunload", myScript);
Remarque : La méthode addEventListener() n'est pas prise en charge dans Internet Explorer 8 et les versions antérieures.
Détails techniques
Bulles: | Non |
---|---|
Annulable : | Oui |
Type d'événement: | UiEvent si généré à partir d'une interface utilisateur, Event sinon |
Balises HTML compatibles : | <corps> |
Version DOM : | Événements de niveau 2 |