diff options
Diffstat (limited to 'files/fr/web/api/beforeunloadevent/index.md')
-rw-r--r-- | files/fr/web/api/beforeunloadevent/index.md | 93 |
1 files changed, 93 insertions, 0 deletions
diff --git a/files/fr/web/api/beforeunloadevent/index.md b/files/fr/web/api/beforeunloadevent/index.md new file mode 100644 index 0000000000..4a74d1689d --- /dev/null +++ b/files/fr/web/api/beforeunloadevent/index.md @@ -0,0 +1,93 @@ +--- +title: BeforeUnloadEvent +slug: Web/API/BeforeUnloadEvent +tags: + - API + - Reference +translation_of: Web/API/BeforeUnloadEvent +--- +<p>{{APIRef}}</p> + +<p>L'évènement <strong><code>beforeunload</code></strong> est déclenché quand la fenêtre, le document et ses ressources sont sur le point d'être déchargées.</p> + +<p>Si une chaine non vide est assignée à la propriété <code>returnValue</code> de l'évènement, une boite de confirmation apparait pour demander à l'utilisateur de valider le changement d'adresse (voir les exemples ci-dessous). Si aucune valeur n'est fournise, l'évènement est traité silencieusement. Certaines implantations ne demandent confirmation que si le cadre ou tout cadre embarqué reçoit une action utilisateur. Voir {{anch("Browser compatibility")}} pour plus d'informations.</p> + +<p>{{InheritanceDiagram(600, 120)}}</p> + +<table class="properties"> + <tbody> + <tr> + <td><strong>Bouillonne</strong></td> + <td>No</td> + </tr> + <tr> + <td><strong>Annulable</strong></td> + <td>Yes</td> + </tr> + <tr> + <td><strong>Cibles</strong></td> + <td>defaultView</td> + </tr> + <tr> + <td><strong>Interface</strong></td> + <td>{{domxref("Event")}}</td> + </tr> + </tbody> +</table> + +<h2 id="Exemples">Exemples</h2> + +<pre class="brush:js;">window.addEventListener("beforeunload", function(event) { + event.returnValue = "\o/"; +}); + +// est équivalent à +window.addEventListener("beforeunload", function(event) { + event.preventDefault(); +});</pre> + +<p>Les navigateurs basés sur WebKit ne suivent pas la spécification concernant la demande de confirmation. Un exemple similaire fonctionnant sur presque tous les navigateurs serait plutôt comme :</p> + +<pre class="brush: js">window.addEventListener("beforeunload", function (e) { + var confirmationMessage = "\o/"; + + (e || window.event).returnValue = confirmationMessage; // Gecko + IE + return confirmationMessage; /* Safari, Chrome, and other + * WebKit-derived browsers */ +});</pre> + +<h2 id="Spécifications">Spécifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Spécification</th> + <th scope="col">État</th> + <th scope="col">Commentaire</th> + </tr> + <tr> + <td>{{SpecName("HTML WHATWG", "browsing-the-web.html#the-beforeunloadevent-interface", "BeforeUnloadEvent")}}</td> + <td>{{Spec2("HTML WHATWG")}}</td> + <td>Définition initiale</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div> + + +<p>{{Compat("api.BeforeUnloadEvent")}}</p> +</div> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>{{Event("DOMContentLoaded")}}</li> + <li>{{Event("readystatechange")}}</li> + <li>{{Event("load")}}</li> + <li>{{Event("beforeunload")}}</li> + <li>{{Event("unload")}}</li> + <li><a href="http://www.whatwg.org/specs/web-apps/current-work/#prompt-to-unload-a-document">Unloading Documents — Prompt to unload a document</a></li> +</ul> |