From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/fr/web/api/windoweventhandlers/index.html | 96 +++++++++++ .../windoweventhandlers/onafterprint/index.html | 67 ++++++++ .../windoweventhandlers/onbeforeprint/index.html | 70 ++++++++ .../windoweventhandlers/onbeforeunload/index.html | 49 ++++++ .../windoweventhandlers/onhashchange/index.html | 181 +++++++++++++++++++++ .../onlanguagechange/index.html | 66 ++++++++ .../api/windoweventhandlers/onpopstate/index.html | 58 +++++++ .../api/windoweventhandlers/onunload/index.html | 58 +++++++ 8 files changed, 645 insertions(+) create mode 100644 files/fr/web/api/windoweventhandlers/index.html create mode 100644 files/fr/web/api/windoweventhandlers/onafterprint/index.html create mode 100644 files/fr/web/api/windoweventhandlers/onbeforeprint/index.html create mode 100644 files/fr/web/api/windoweventhandlers/onbeforeunload/index.html create mode 100644 files/fr/web/api/windoweventhandlers/onhashchange/index.html create mode 100644 files/fr/web/api/windoweventhandlers/onlanguagechange/index.html create mode 100644 files/fr/web/api/windoweventhandlers/onpopstate/index.html create mode 100644 files/fr/web/api/windoweventhandlers/onunload/index.html (limited to 'files/fr/web/api/windoweventhandlers') 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 +--- +
{{APIRef("HTML DOM")}}
+ +
La mixin WindowEventHandlers 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.
+ +
 
+ +
+

Note: WindowEventHandlers est une mixin et non une interface; il n'est pas possible de créer un objet de type WindowEventHandlers.

+
+ +

Propriétés

+ +

Les propriétés d'événement, de la forme onXYZ, sont définis sur {{domxref("WindowEventHandlers")}} et implémentées par {{domxref("Window")}} ou {{domxref("WorkerGlobalScope")}} pour les Web Workers.

+ +
+
{{domxref("WindowEventHandlers.onafterprint")}}
+
Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("afterprint")}} est déclenché.
+
{{domxref("WindowEventHandlers.onbeforeprint")}}
+
Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("beforeprint")}} est déclenché.
+
{{domxref("WindowEventHandlers.onbeforeunload")}}
+
Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("beforeunload")}} est déclenché.
+
{{domxref("WindowEventHandlers.onhashchange")}}
+
Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("hashchange")}} est déclenché.
+
{{domxref("WindowEventHandlers.onlanguagechange")}} {{experimental_inline}}
+
Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("languagechange")}} est déclenché.
+
{{domxref("WindowEventHandlers.onmessage")}}
+
Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("message")}} est déclenché.
+
{{domxref("WindowEventHandlers.onoffline")}}
+
Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("offline")}} est déclenché.
+
{{domxref("WindowEventHandlers.ononline")}}
+
Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("online")}} est déclenché.
+
{{domxref("WindowEventHandlers.onpagehide")}}
+
Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("pagehide")}} est déclenché.
+
{{domxref("WindowEventHandlers.onpageshow")}}
+
Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("pageshow")}} est déclenché.
+
{{domxref("WindowEventHandlers.onpopstate")}}
+
Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("popstate")}} est déclenché.
+
{{domxref("WindowEventHandlers.onresize")}}
+
Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("resize")}} est déclenché.
+
{{domxref("WindowEventHandlers.onstorage")}}
+
Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("storage")}} est déclenché.
+
{{domxref("WindowEventHandlers.onunload")}}
+
Est un {{domxref("EventHandler")}} représentant le code à appeler lorsque l'événement {{event("unload")}} est déclenché.
+
+ +

Méthodes

+ +

Cette interface ne définit aucune méthode.

+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('HTML WHATWG', '#windoweventhandlers', 'GlobalEventHandlers')}}{{Spec2('HTML WHATWG')}}Pas de changement depuis {{SpecName("HTML5.1")}}.
{{SpecName('HTML5.1', '#windoweventhandlers', 'GlobalEventHandlers')}}{{Spec2('HTML5.1')}}Snapshot de {{SpecName("HTML WHATWG")}}. Ajoute onlanguage.
{{SpecName("HTML5 W3C", "#windoweventhandlers", "GlobalEventHandlers")}}{{Spec2('HTML5 W3C')}}Snapshot de {{SpecName("HTML WHATWG")}}. Création de WindowEventHandlers (les propriétés étaient sur la cible avant).
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.WindowEventHandlers")}}

+ +

Voir aussi

+ + 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 +--- +
{{ApiRef}}
+ +

La propriété WindowEventHandlers.onafterprint définit et renvoie {{event("afterprint")}} {{domxref("EventHandler")}} pourl a fenêtre actuelle.

+ +

Syntaxe

+ +
window.onafterprint = code de traitement de l'événement
+
+ +

Notes

+ +

Les événements beforeprint et afterprint 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 @media print, mais il peut être nécessaire d'utiliser ces événements dans certains cas.

+ +

L'événement afterprint est appelé après l'impression par l'utilisateur, ou s'il interrompt la boîte de dialogue d'impression.

+ +

 

+ +

 

+ +

Safari ne reconnaît pas ces événements.

+ +

Spécification

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('HTML WHATWG', '#handler-window-onafterprint', 'onafterprint')}}{{Spec2('HTML WHATWG')}} 
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.WindowEventHandlers.onafterprint")}}

+ +

Voir également

+ + + +
 
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 +--- +
{{ApiRef}}
+ +

La propriété onbeforeprint définit et retourne le code du gestionnaire d'événement onbeforeprint onbeforeprint pour la fenêtre actuelle.

+ +

Syntaxe

+ +
window.onbeforeprint = code de traitement de l'événement
+
+ +

Notes

+ +

Les événements beforeprint et afterprint 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 @media print, mais il peut être nécessaire d'utiliser ces événements dans certains cas.

+ +

L'événement beforeprint est appelé avant l'ouverture de la fenêtre de dialogue d'impression.

+ +

Safari ne reconnaît pas ces événements, mais un résultat équivalent à l'événement beforeprint peut être obtenu avec {{domxref("window.matchMedia")}}('print').

+ +

 

+ +

 

+ +
var mediaQueryList = window.matchMedia('print');
+mediaQueryList.addListener(function(mql) {
+  if(mql.matches) {
+    console.log('équivalent webkit de onbeforeprint');
+  }
+});
+ +

Spécification

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('HTML WHATWG', '#handler-window-onbeforeprint', 'onbeforeprint')}}{{Spec2('HTML WHATWG')}} 
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.WindowEventHandlers.onbeforeprint")}}

+ +

Voir également

+ + 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 +--- +

Résumé

+ +

Le gestionnaire d'événement WindowEventHandlers.onbeforeunload 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.

+ +

Syntaxe

+ +
<element beforeunload="funcRef(event);" />
+ +
<script type="text/javascript">
+	window.onbeforeunload = funcRef
+</script>
+ + + +

Exemple

+ +
window.onbeforeunload = function (e) {
+  var e = e || window.event;
+
+  // For IE and Firefox
+  if (e) {
+    e.returnValue = 'Any string';
+  }
+
+  // For Safari
+  return 'Any string';
+};
+
+ +

Propriétés de l'objet event

+ +
returnValue
+ + + +

Spécification

+ +

L'évènement 'onbeforeunload' a été introduit par Microsoft dans IE4 et s'est généralisé dans tous les navigateurs.

+ +

MSDN—onbeforeunload Event

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 +--- +
+
{{APIRef("HTML DOM")}}
+ +
L'événement hashchange est déclenché lorsque le hash de l'url change (cf. {{domxref("Window.location", "location.hash")}}).
+ +
 
+
+ +

Syntaxe

+ +
window.onhashchange = funcRef;
+
+ +

ou

+ +
<body onhashchange="funcRef();">
+
+ +

ou

+ +
window.addEventListener("hashchange", funcRef, false);
+
+ +

Paramètres

+ +
+
funcRef
+
Une référence à une fonction.
+
+ +

Exemples

+ +
if ("onhashchange" in window) {
+    alert("Le navigateur prend en charge l'événement hashchange!");
+}
+
+function locationHashChanged() {
+    if (location.hash === "#somecoolfeature") {
+        somecoolfeature();
+    }
+}
+
+window.onhashchange = locationHashChanged;
+
+ +

L'événement hashchange

+ +

Lorsque l'observateur d'événement déclenche l'événement hashchange il passe en paramêtres les arguments suivante:

+ + + + + + + + + + + + + + + + + + + +
ParamêtreTypeDescription
newURL {{gecko_minversion_inline("6.0")}}DOMStringLe nouvel URL où le navigateur est.
oldURL {{gecko_minversion_inline("6.0")}}DOMStringL'ancien URL où le navigateur se trouvait.
+ +

Une solution autour de event.newURL et event.oldURL

+ +
//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;
+	});
+}());
+
+ +

 

+ +

Spécifications 

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
SpécificationsStatutCommentaires
{{SpecName('HTML WHATWG', '#windoweventhandlers', 'GlobalEventHandlers')}}{{Spec2('HTML WHATWG')}} 
{{SpecName('HTML5.1', '#windoweventhandlers', 'GlobalEventHandlers')}}{{Spec2('HTML5.1')}} 
{{SpecName("HTML5 W3C", "#windoweventhandlers", "GlobalEventHandlers")}}{{Spec2('HTML5 W3C')}} 
+ +

Compatibilité des navigateurs

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
FonctionnalitéChromeFirefox (Gecko)Internet ExplorerOperaSafari
Support de base5.0{{CompatGeckoDesktop("1.9.2")}} +

8.0

+ +

oldURL/newURL attributes are not supported.

+ 		10.65.0
+
+ +
+ + + + + + + + + + + + + + + + + + + +
FonctionnalitéAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Support de base2.2{{CompatGeckoMobile("1.9.2")}}9.011.05.0
+ +

 

+ +

Lire également

+
+ + 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 +--- +
{{APIRef("HTML DOM")}} {{SeeCompatTable}}
+ +

La propriété onlanguagechange du mixin {{domxref("WindowEventHandlers")}} est le {{domxref("EventHandler")}} pour le traitement des événements {{event("languagechange")}}.

+ +

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")}}.

+ +

Syntaxe

+ +
object.onlanguagechange = function;
+
+ +

Valeur

+ + + +

Exemple

+ +
window.onlanguagechange = function(event) {
+  console.log('événement de changement de langue détecté!');
+};
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{ SpecName('HTML WHATWG', '#handler-window-onlanguagechange', 'WindowEventHandler.onlanguagechange') }}{{ Spec2('HTML WHATWG') }}Spécification initiale.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.WindowEventHandlers.onlanguagechange")}}

+ +

Voir également

+ + 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 +--- +

{{ ApiRef() }}

+ +

{{ gecko_minversion_header("2") }}

+ +

Résumé

+ +

Un gestionnaire d'évènement pour l'évènement popstate de la fenêtre.

+ +

L'évènement popstate 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 history.pushState() ou a été modifiée en appelant history.replaceState(), la propriété state de l'évènement popstate contient une copie de l'objet d'entrée de l'historique.

+ +

Sachez qu'appeler history.pushState() ou history.replaceState() ne déclenchera pas l'évènement popstate. Cet évènement n'est déclenché que par une action utilisateur telle que cliquer sur le bouton Retour (ou appeler history.back(), en JavaScript). L'évènement n'est déclenché que pour la navigation entre deux entrées du même document.

+ +

Syntaxe

+ +
window.onpopstate = funcRef;
+
+ + + +

L'évènement popstate

+ +

Par exemple, une page à l'adresse http://example.com/example.html exécutant le code suivant générera les alertes suivantes:

+ +
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}
+
+ +

Même si l'entrée originelle (de http://example.com/example.html) n'a aucun objet d'état associé, l'évènement popstate est toujours déclenché lorsque l'entrée est activée après un deuxième appel à history.back().

+ +

Spécification

+ + + +

Lire également

+ + + +

{{ languages( {"zh-cn": "zh-cn/DOM/window.onpopstate" } ) }}

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 +--- +
{{APIRef("HTML DOM")}}
+ +

L'événement unload 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 après que l'événement unload a eu lieu.

+ +

Les navigateurs équipés d'un bloqueur de pop-up vont ignorer tout appel de window.open() lancé depuis onunload.

+ +

Syntaxe

+ +
window.addEventListener("unload", function(event) { ... });
+window.onunload = function(event) { ... };
+
+ +

Généralement, mieux vaut utiliser {{domxref("EventTarget.addEventListener", "window.addEventListener()")}} et l'événement {{event("unload")}} plutôt que onunload.

+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
SpécificationÉtatCommentaires
{{SpecName('HTML WHATWG', '#handler-window-onunload', 'onunload')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5.1', '#windoweventhandlers', 'GlobalEventHandlers')}}{{Spec2('HTML5.1')}}
{{SpecName("HTML5 W3C", "#windoweventhandlers", "GlobalEventHandlers")}}{{Spec2('HTML5 W3C')}}
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.WindowEventHandlers.onunload")}}

-- cgit v1.2.3-54-g00ecf