diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
commit | 33058f2b292b3a581333bdfb21b8f671898c5060 (patch) | |
tree | 51c3e392513ec574331b2d3f85c394445ea803c6 /files/fr/web/api/windoweventhandlers | |
parent | 8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff) | |
download | translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2 translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip |
initial commit
Diffstat (limited to 'files/fr/web/api/windoweventhandlers')
8 files changed, 645 insertions, 0 deletions
diff --git a/files/fr/web/api/windoweventhandlers/index.html b/files/fr/web/api/windoweventhandlers/index.html new file mode 100644 index 0000000000..40c8846588 --- /dev/null +++ b/files/fr/web/api/windoweventhandlers/index.html @@ -0,0 +1,96 @@ +--- +title: WindowEventHandlers +slug: Web/API/WindowEventHandlers +tags: + - API +translation_of: Web/API/WindowEventHandlers +--- +<div>{{APIRef("HTML DOM")}}</div> + +<div>La mixin <strong><code>WindowEventHandlers</code></strong> décrit les gestionnaires d'événements communs à plusieurs interfaces comme {{domxref("Window")}}, or {{domxref("HTMLBodyElement")}} et {{domxref("HTMLFrameSetElement")}}. Chacune de ces interfaces peut implémenter des gestionnaires d'événement supplémentaires.</div> + +<div> </div> + +<div class="note"> +<p><strong>Note</strong>: <code>WindowEventHandlers</code> est une mixin et non une interface; il n'est pas possible de créer un objet de type <code>WindowEventHandlers</code>.</p> +</div> + +<h2 id="Propriétés">Propriétés</h2> + +<p><em>Les propriétés d'événement, de la forme <code>onXYZ</code>, sont définis sur {{domxref("WindowEventHandlers")}} et implémentées par {{domxref("Window")}} ou {{domxref("WorkerGlobalScope")}} pour les Web Workers.</em></p> + +<dl> + <dt>{{domxref("WindowEventHandlers.onafterprint")}}</dt> + <dd>Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("afterprint")}} est déclenché.</dd> + <dt>{{domxref("WindowEventHandlers.onbeforeprint")}}</dt> + <dd>Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("beforeprint")}} est déclenché.</dd> + <dt>{{domxref("WindowEventHandlers.onbeforeunload")}}</dt> + <dd>Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("beforeunload")}} est déclenché.</dd> + <dt>{{domxref("WindowEventHandlers.onhashchange")}}</dt> + <dd>Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("hashchange")}} est déclenché.</dd> + <dt>{{domxref("WindowEventHandlers.onlanguagechange")}} {{experimental_inline}}</dt> + <dd>Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("languagechange")}} est déclenché.</dd> + <dt>{{domxref("WindowEventHandlers.onmessage")}}</dt> + <dd>Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("message")}} est déclenché.</dd> + <dt>{{domxref("WindowEventHandlers.onoffline")}}</dt> + <dd>Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("offline")}} est déclenché.</dd> + <dt>{{domxref("WindowEventHandlers.ononline")}}</dt> + <dd>Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("online")}} est déclenché.</dd> + <dt>{{domxref("WindowEventHandlers.onpagehide")}}</dt> + <dd>Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("pagehide")}} est déclenché.</dd> + <dt>{{domxref("WindowEventHandlers.onpageshow")}}</dt> + <dd>Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("pageshow")}} est déclenché.</dd> + <dt>{{domxref("WindowEventHandlers.onpopstate")}}</dt> + <dd>Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("popstate")}} est déclenché.</dd> + <dt>{{domxref("WindowEventHandlers.onresize")}}</dt> + <dd>Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("resize")}} est déclenché.</dd> + <dt>{{domxref("WindowEventHandlers.onstorage")}}</dt> + <dd>Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("storage")}} est déclenché.</dd> + <dt>{{domxref("WindowEventHandlers.onunload")}}</dt> + <dd>Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("unload")}} est déclenché.</dd> +</dl> + +<h2 id="Méthodes">Méthodes</h2> + +<p><em>Cette interface ne définit aucune méthode.</em></p> + +<h2 id="Spécifications">Spécifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', '#windoweventhandlers', 'GlobalEventHandlers')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>Pas de changement depuis {{SpecName("HTML5.1")}}.</td> + </tr> + <tr> + <td>{{SpecName('HTML5.1', '#windoweventhandlers', 'GlobalEventHandlers')}}</td> + <td>{{Spec2('HTML5.1')}}</td> + <td>Snapshot de {{SpecName("HTML WHATWG")}}. Ajoute <code>onlanguage</code>.</td> + </tr> + <tr> + <td>{{SpecName("HTML5 W3C", "#windoweventhandlers", "GlobalEventHandlers")}}</td> + <td>{{Spec2('HTML5 W3C')}}</td> + <td>Snapshot de {{SpecName("HTML WHATWG")}}. Création de <code>WindowEventHandlers</code> (les propriétés étaient sur la cible avant).</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div class="hidden">Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et à nous envoyer une <em>pull request</em>.</div> + +<p>{{Compat("api.WindowEventHandlers")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>{{domxref("Window")}} et {{domxref("WorkerGlobalScope")}}</li> +</ul> diff --git a/files/fr/web/api/windoweventhandlers/onafterprint/index.html b/files/fr/web/api/windoweventhandlers/onafterprint/index.html new file mode 100644 index 0000000000..3a7b4c259b --- /dev/null +++ b/files/fr/web/api/windoweventhandlers/onafterprint/index.html @@ -0,0 +1,67 @@ +--- +title: WindowEventHandlers.onafterprint +slug: Web/API/WindowEventHandlers/onafterprint +tags: + - API + - DOM + - HTML-DOM + - Propriété + - Reference + - Window + - impression + - évènements +translation_of: Web/API/WindowEventHandlers/onafterprint +--- +<div>{{ApiRef}}</div> + +<p>La propriété WindowEventHandlers.onafterprint définit et renvoie {{event("afterprint")}} {{domxref("EventHandler")}} pourl a fenêtre actuelle.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox"><em>window</em>.onafterprint = <em>code de traitement de l'événement</em> +</pre> + +<h2 id="Notes">Notes</h2> + +<p>Les événements <code>beforeprint</code> et <code>afterprint</code> permettent aux pages de modifier leur contenu avant le début de l'impression (pour supprimer une bannière, par exemple), puis d'annuler ces modifications une fois l'impression terminée. En général, les auteurs de contenu devraient préférer l'utilisation d'une règle CSS <a href="/en-US/docs/Web/CSS/@media">@media print</a>, mais il peut être nécessaire d'utiliser ces événements dans certains cas.</p> + +<p>L'événement <code>afterprint</code> est appelé après l'impression par l'utilisateur, ou s'il interrompt la boîte de dialogue d'impression.</p> + +<p> </p> + +<p> </p> + +<p>Safari ne reconnaît pas ces événements.</p> + +<h2 id="Spécification">Spécification</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('HTML WHATWG', '#handler-window-onafterprint', 'onafterprint')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + + + +<p>{{Compat("api.WindowEventHandlers.onafterprint")}}</p> + +<h2 id="Voir_également">Voir également</h2> + +<ul> + <li>{{domxref("window.print")}}</li> + <li>{{domxref("window.onbeforeprint")}}</li> + <li><a href="/en-US/docs/Printing" title="Printing">Printing</a></li> +</ul> + +<div class="grammarly-disable-indicator"> </div> diff --git a/files/fr/web/api/windoweventhandlers/onbeforeprint/index.html b/files/fr/web/api/windoweventhandlers/onbeforeprint/index.html new file mode 100644 index 0000000000..4f5e06adb8 --- /dev/null +++ b/files/fr/web/api/windoweventhandlers/onbeforeprint/index.html @@ -0,0 +1,70 @@ +--- +title: WindowEventHandlers.onbeforeprint +slug: Web/API/WindowEventHandlers/onbeforeprint +tags: + - API + - DOM + - Propriété + - impression +translation_of: Web/API/WindowEventHandlers/onbeforeprint +--- +<div>{{ApiRef}}</div> + +<p>La propriété <code>onbeforeprint</code> définit et retourne le code du gestionnaire d'événement <code>onbeforeprint</code> onbeforeprint pour la fenêtre actuelle.</p> + +<h2 id="Syntax" name="Syntax">Syntaxe</h2> + +<pre class="syntaxbox">window.onbeforeprint = <em>code de traitement de l'événement</em> +</pre> + +<h2 class="Notes" id="Notes">Notes</h2> + +<p>Les événements <code>beforeprint</code> et <code>afterprint</code> permettent aux pages de modifier leur contenu avant le début de l'impression (peut-être pour supprimer une bannière, par exemple), puis d'annuler ces modifications une fois l'impression terminée. En général, les auteurs de contenu devraient préférer l'utilisation d'une règle CSS <a href="/en-US/docs/Web/CSS/@media">@media print</a>, mais il peut être nécessaire d'utiliser ces événements dans certains cas.</p> + +<p>L'événement <code>beforeprint</code> est appelé avant l'ouverture de la fenêtre de dialogue d'impression.</p> + +<p>Safari ne reconnaît pas ces événements, mais un résultat équivalent à l'événement <code>beforeprint</code> peut être obtenu avec <code>{{domxref("window.matchMedia")}}('print')</code>.</p> + +<p> </p> + +<p> </p> + +<pre class="brush: js">var mediaQueryList = window.matchMedia('print'); +mediaQueryList.addListener(function(mql) { + if(mql.matches) { + console.log('équivalent webkit de onbeforeprint'); + } +});</pre> + +<h2 id="Specification" name="Specification">Spécification</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', '#handler-window-onbeforeprint', 'onbeforeprint')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">Compatibilité des navigateurs</h2> + + + +<p>{{Compat("api.WindowEventHandlers.onbeforeprint")}}</p> + +<h2 id="See_also" name="See_also">Voir également</h2> + +<ul> + <li>{{domxref("window.print")}}</li> + <li>{{domxref("window.onafterprint")}}</li> + <li><a href="/en-US/docs/Printing">Printing</a></li> +</ul> diff --git a/files/fr/web/api/windoweventhandlers/onbeforeunload/index.html b/files/fr/web/api/windoweventhandlers/onbeforeunload/index.html new file mode 100644 index 0000000000..b63c5b4caf --- /dev/null +++ b/files/fr/web/api/windoweventhandlers/onbeforeunload/index.html @@ -0,0 +1,49 @@ +--- +title: window.onbeforeunload +slug: Web/API/WindowEventHandlers/onbeforeunload +translation_of: Web/API/WindowEventHandlers/onbeforeunload +--- +<h2 id="Sommaire" name="Sommaire">Résumé</h2> + +<p>Le gestionnaire d'événement <code><strong>WindowEventHandlers.onbeforeunload</strong></code> contient le code exécuté lorsque l'évènement {{event("beforeunload")}} est envoyé. Cet événement se déclenche lorsque la fenêtre est sur le point de recharger ses ressources.</p> + +<h2 id="Syntaxe" name="Syntaxe">Syntaxe</h2> + +<pre class="brush: html"><element beforeunload="funcRef(event);" /></pre> + +<pre class="brush: js"><script type="text/javascript"> + window.onbeforeunload = funcRef +</script></pre> + +<ul> + <li>funcRef : Référence à une fonction appelée lorsque l'évènement se déclenche</li> +</ul> + +<h2 id="Exemple" name="Exemple">Exemple</h2> + +<pre class="brush: js">window.onbeforeunload = function (e) { + var e = e || window.event; + + // For IE and Firefox + if (e) { + e.returnValue = 'Any string'; + } + + // For Safari + return 'Any string'; +}; +</pre> + +<h2 id="EventProperty" name="EventProperty">Propriétés de l'objet <strong>event</strong></h2> + +<pre>returnValue</pre> + +<ul> + <li>Applique ou récupère la valeur de retour de l'évènement.</li> +</ul> + +<h2 id="Spécification">Spécification</h2> + +<p>L'évènement 'onbeforeunload' a été introduit par Microsoft dans IE4 et s'est généralisé dans tous les navigateurs.</p> + +<p><a class="external" href="http://msdn.microsoft.com/en-us/library/ms536907%28VS.85%29.aspx" title="MSDN—onbeforeunload Event">MSDN—onbeforeunload Event</a></p> diff --git a/files/fr/web/api/windoweventhandlers/onhashchange/index.html b/files/fr/web/api/windoweventhandlers/onhashchange/index.html new file mode 100644 index 0000000000..bbb31c4752 --- /dev/null +++ b/files/fr/web/api/windoweventhandlers/onhashchange/index.html @@ -0,0 +1,181 @@ +--- +title: WindowEventHandlers.onhashchange +slug: Web/API/WindowEventHandlers/onhashchange +translation_of: Web/API/WindowEventHandlers/onhashchange +--- +<div> +<div>{{APIRef("HTML DOM")}}</div> + +<div>L'événement <strong>hashchange</strong> est déclenché lorsque le hash de l'url change (cf. {{domxref("Window.location", "location.hash")}}).</div> + +<div> </div> +</div> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox">window.onhashchange = funcRef; +</pre> + +<p><strong>ou</strong></p> + +<pre class="syntaxbox"><body onhashchange="funcRef();"> +</pre> + +<p><strong>ou</strong></p> + +<pre class="syntaxbox">window.addEventListener("hashchange", funcRef, false); +</pre> + +<h3 id="Paramètres">Paramètres</h3> + +<dl> + <dt><code>funcRef</code></dt> + <dd>Une référence à une fonction.</dd> +</dl> + +<h2 id="Exemples">Exemples</h2> + +<pre class="brush:js">if ("onhashchange" in window) { + alert("Le navigateur prend en charge l'événement hashchange!"); +} + +function locationHashChanged() { + if (location.hash === "#somecoolfeature") { + somecoolfeature(); + } +} + +window.onhashchange = locationHashChanged; +</pre> + +<h2 id="L'événement_hashchange">L'événement hashchange</h2> + +<p>Lorsque l'observateur d'événement déclenche l'événement hashchange il passe en paramêtres les arguments suivante:</p> + +<table class="standard-table"> + <tbody> + <tr> + <td class="header">Paramêtre</td> + <td class="header">Type</td> + <td class="header">Description</td> + </tr> + <tr> + <td><code>newURL</code> {{gecko_minversion_inline("6.0")}}</td> + <td><code>DOMString</code></td> + <td>Le nouvel URL où le navigateur est.</td> + </tr> + <tr> + <td><code>oldURL</code> {{gecko_minversion_inline("6.0")}}</td> + <td><code>DOMString</code></td> + <td>L'ancien URL où le navigateur se trouvait.</td> + </tr> + </tbody> +</table> + +<h3 id="Une_solution_autour_de_event.newURL_et_event.oldURL">Une solution autour de event.newURL et event.oldURL</h3> + +<pre class="brush:js">//insérez ce bout de code au début de votre code pour observer les changements de hash dans l'URL +if(!window.HashChangeEvent)(function(){ + var lastURL=document.URL; + window.addEventListener("hashchange",function(event){ + Object.defineProperty(event,"oldURL",{enumerable:true,configurable:true,value:lastURL}); + Object.defineProperty(event,"newURL",{enumerable:true,configurable:true,value:document.URL}); + lastURL=document.URL; + }); +}()); +</pre> + +<h3 id="sect1"> </h3> + +<h2 id="Spécifications">Spécifications </h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Spécifications</th> + <th scope="col">Statut</th> + <th scope="col">Commentaires</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', '#windoweventhandlers', 'GlobalEventHandlers')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName('HTML5.1', '#windoweventhandlers', 'GlobalEventHandlers')}}</td> + <td>{{Spec2('HTML5.1')}}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName("HTML5 W3C", "#windoweventhandlers", "GlobalEventHandlers")}}</td> + <td>{{Spec2('HTML5 W3C')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">Compatibilité des navigateurs</h2> + +<p>{{CompatibilityTable}}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Fonctionnalité</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari</th> + </tr> + <tr> + <td>Support de base</td> + <td>5.0</td> + <td>{{CompatGeckoDesktop("1.9.2")}}</td> + <td> + <p>8.0</p> + + <p><code style="font-size: 14px;">oldURL</code>/<code style="font-size: 14px;">newURL</code> attributes are not supported.</p> + </td> + <td>10.6</td> + <td>5.0</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Fonctionnalité</th> + <th>Android</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>Support de base</td> + <td>2.2</td> + <td>{{CompatGeckoMobile("1.9.2")}}</td> + <td>9.0</td> + <td>11.0</td> + <td>5.0</td> + </tr> + </tbody> +</table> + +<p> </p> + +<h2 id="Lire_également">Lire également</h2> +</div> + +<ul> + <li><a href="/fr/docs/Web/Guide/DOM/Manipuler_historique_du_navigateur">Manipuler l'historique du navigateur</a></li> + <li>Méthodes <a href="/fr/docs/Web/API/Window/history" title="DOM/window.history">history.pushState() et history.replaceState()</a></li> + <li>L'événement <a href="/fr/docs/Web/API/WindowEventHandlers/onpopstate" title="DOM/window.onpopstate">popstate</a></li> +</ul> diff --git a/files/fr/web/api/windoweventhandlers/onlanguagechange/index.html b/files/fr/web/api/windoweventhandlers/onlanguagechange/index.html new file mode 100644 index 0000000000..aaa590371d --- /dev/null +++ b/files/fr/web/api/windoweventhandlers/onlanguagechange/index.html @@ -0,0 +1,66 @@ +--- +title: WindowEventHandlers.onlanguagechange +slug: Web/API/WindowEventHandlers/onlanguagechange +tags: + - API + - Event Handler + - Experimental + - Propriété + - Reference + - Window +translation_of: Web/API/WindowEventHandlers/onlanguagechange +--- +<div>{{APIRef("HTML DOM")}} {{SeeCompatTable}}</div> + +<p>La propriété <code><strong>onlanguagechange</strong></code> du mixin {{domxref("WindowEventHandlers")}} est le {{domxref("EventHandler")}} pour le traitement des événements {{event("languagechange")}}.</p> + +<p>Ces événements sont reçus par l'objet implémentant cette interface, généralement un {{domxref ("Window")}}, un {{domxref ("HTMLBodyElement")}} ou un {{domxref ("HTMLIFrameElement")}}. Un tel événement est envoyé par le navigateur pour informer que la liste des langues préférées a été mise à jour. La liste est accessible via {{domxref("NavigatorLanguage.languages")}}.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox notranslate"><em>object</em>.onlanguagechange = <em>function</em>; +</pre> + +<h3 id="Valeur">Valeur</h3> + +<ul> + <li><code>function</code> est le nom d'une fonction définie par l'utilisateur, sans le suffixe <code>()</code> ni aucun paramètre, ou une déclaration de fonction anonyme, telle que <code>function(event) {...}</code>. Un gestionnaire d'événements a toujours un seul paramètre, contenant l'événement, ici de type {{domxref ("Event")}}.</li> +</ul> + +<h2 id="Exemple">Exemple</h2> + +<pre class="brush: js notranslate">window.onlanguagechange = function(event) { + console.log('événement de changement de langue détecté!'); +}; +</pre> + +<h2 id="Spécifications">Spécifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Spécification</th> + <th scope="col">Statut</th> + <th scope="col">Commentaire</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{ SpecName('HTML WHATWG', '#handler-window-onlanguagechange', 'WindowEventHandler.onlanguagechange') }}</td> + <td>{{ Spec2('HTML WHATWG') }}</td> + <td>Spécification initiale.</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div class="hidden">Le tableau de compatibilité de cette page est généré à partir de données structurées. Si vous souhaitez contribuer aux données, veuillez consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et envoyez-nous une pull request.</div> + +<p>{{Compat("api.WindowEventHandlers.onlanguagechange")}}</p> + +<h2 id="Voir_également">Voir également</h2> + +<ul> + <li>L'événement {{event("languagechange")}} et son type, {{domxref("Event")}}</li> +</ul> diff --git a/files/fr/web/api/windoweventhandlers/onpopstate/index.html b/files/fr/web/api/windoweventhandlers/onpopstate/index.html new file mode 100644 index 0000000000..1eb120e770 --- /dev/null +++ b/files/fr/web/api/windoweventhandlers/onpopstate/index.html @@ -0,0 +1,58 @@ +--- +title: window.onpopstate +slug: Web/API/WindowEventHandlers/onpopstate +translation_of: Web/API/WindowEventHandlers/onpopstate +--- +<p>{{ ApiRef() }}</p> + +<p>{{ gecko_minversion_header("2") }}</p> + +<h3 id="Résumé">Résumé</h3> + +<p>Un gestionnaire d'évènement pour l'évènement <code>popstate</code> de la fenêtre.</p> + +<p><span style="line-height: inherit;">L'évènement <code>popstate</code></span> est envoyé à la fenêtre à chaque fois que l'entrée actuelle de l'historique change avec 2 autres entrées du même document. Si l'entrée actuelle a été créée en appelant <code>history.pushState()</code> ou a été modifiée en appelant <code>history.replaceState()</code>, la propriété <font face="Courier New, Andale Mono, monospace">state</font> de l'évènement <code>popstate</code> contient une copie de l'objet d'entrée de l'historique.</p> + +<p>Sachez qu'appeler <code>history.pushState()</code> ou <code>history.replaceState()</code> ne déclenchera pas l'évènement <code>popstate</code>. Cet évènement n'est déclenché que par une action utilisateur telle que cliquer sur le bouton Retour (ou appeler <code>history.back()</code>, en JavaScript). L'évènement n'est déclenché que pour la navigation entre deux entrées du même document.</p> + +<h3 id="Syntax" name="Syntax">Syntaxe</h3> + +<pre class="eval">window.onpopstate = <em>funcRef</em>; +</pre> + +<ul> + <li><code>funcRef</code> est une référence à une fonction.</li> +</ul> + +<h3 id="Lévènement_popstate">L'évènement popstate</h3> + +<p>Par exemple, une page à l'adresse <a class="external" href="http://example.com/example.html" rel="freelink">http://example.com/example.html</a> exécutant le code suivant générera les alertes suivantes:</p> + +<pre class="brush: js">window.onpopstate = function(event) { + alert("adresse: " + document.location + ", état: " + JSON.stringify(event.state)); +}; +history.pushState({page: 1}, "titre 1", "?page=1"); +history.pushState({page: 2}, "titre 2", "?page=2"); +history.replaceState({page: 3}, "titre 3", "?page=3"); +history.back(); // affiche "adresse: http://example.com/example.html?page=1, état: {"page":1}" +history.back(); // affiche "adresse: http://example.com/example.html, état: null +history.go(2); // affiche "adresse: http://example.com/example.html?page=3, état: {"page":3} +</pre> + +<p>Même si l'entrée originelle (de <a class="external" href="http://example.com/example.html" rel="freelink">http://example.com/example.html</a>) n'a aucun objet d'état associé, l'évènement <code>popstate</code> est toujours déclenché lorsque l'entrée est activée après un deuxième appel à <code>history.back()</code>.</p> + +<h3 id="Specification" name="Specification">Spécification</h3> + +<ul> + <li><a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/#handler-window-onpopstate" title="http://www.whatwg.org/specs/web-apps/current-work/#handler-window-onpopstate">HTML5 popstate event</a></li> +</ul> + +<h3 id="Lire_également">Lire également</h3> + +<ul> + <li>{{ domxref("window.history") }}</li> + <li><a href="/fr/docs/DOM/manipuler_lhistorique_du_navigateur" title="/fr/docs/DOM/manipuler_lhistorique_du_navigateur">Manipuler l'historique du navigateur</a></li> + <li><a href="/fr/docs/DOM/Manipulating_the_browser_history/Example" title="/fr/docs/DOM/Manipulating_the_browser_history/Example">Exemple de navigation en Ajax</a></li> +</ul> + +<p>{{ languages( {"zh-cn": "zh-cn/DOM/window.onpopstate" } ) }}</p> diff --git a/files/fr/web/api/windoweventhandlers/onunload/index.html b/files/fr/web/api/windoweventhandlers/onunload/index.html new file mode 100644 index 0000000000..e218cb7656 --- /dev/null +++ b/files/fr/web/api/windoweventhandlers/onunload/index.html @@ -0,0 +1,58 @@ +--- +title: WindowEventHandlers.onunload +slug: Web/API/WindowEventHandlers/onunload +tags: + - API + - Propriétés + - Reference + - WindowEventHandlers +translation_of: Web/API/WindowEventHandlers/onunload +--- +<div>{{APIRef("HTML DOM")}}</div> + +<p>L'événement <strong><code>unload</code></strong> est déclenché lorsque le contenu et les ressources sont déchargés à la fermeture de la fenêtre. Le processus de suppression des ressources se fait <em>après</em> que l'événement <code>unload </code>a eu lieu.</p> + +<p>Les navigateurs équipés d'un bloqueur de pop-up vont ignorer tout appel de window.open() lancé depuis onunload.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox">window.addEventListener("unload", function(event) { ... }); +window.onunload = function(event) { ... }; +</pre> + +<p>Généralement, mieux vaut utiliser {{domxref("EventTarget.addEventListener", "window.addEventListener()")}} et l'événement {{event("unload")}} plutôt que <code>onunload</code>.</p> + +<h2 id="Spécifications">Spécifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Spécification</th> + <th scope="col">État</th> + <th scope="col">Commentaires</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', '#handler-window-onunload', 'onunload')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName('HTML5.1', '#windoweventhandlers', 'GlobalEventHandlers')}}</td> + <td>{{Spec2('HTML5.1')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName("HTML5 W3C", "#windoweventhandlers", "GlobalEventHandlers")}}</td> + <td>{{Spec2('HTML5 W3C')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div class="hidden">Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et à nous envoyer une <em>pull request</em>.</div> + +<p>{{Compat("api.WindowEventHandlers.onunload")}}</p> |