From d1a7d7b07db0dbc3541db034856b9b419549ceac Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 07:57:10 +0200 Subject: [PATCH 01/27] update scrollleft vs en-US --- files/fr/web/api/element/scrollleft/index.md | 94 +++++++++++--------- 1 file changed, 54 insertions(+), 40 deletions(-) diff --git a/files/fr/web/api/element/scrollleft/index.md b/files/fr/web/api/element/scrollleft/index.md index 3fafc4443a3979..0e7acba5b4f43a 100644 --- a/files/fr/web/api/element/scrollleft/index.md +++ b/files/fr/web/api/element/scrollleft/index.md @@ -1,64 +1,78 @@ --- -title: element.scrollLeft +title: Element.scrollLeft slug: Web/API/Element/scrollLeft -tags: - - DOM - - DOM_0 translation_of: Web/API/Element/scrollLeft +browser-compat: api.Element.scrollLeft --- -{{ ApiRef() }} +{{APIRef("DOM")}} -### Résumé +La propriété **`Element.scrollLeft`** permet de lire ou de modifier le nombre de pixels le long desquels le contenu d'un élément a défilé depuis son bord gauche. -Définit ou obtient le nombre de pixels dont le contenu est défilé vers la gauche. +Si la propriété [`direction`](/fr/docs/Web/CSS/direction) de l'élément vaut `rtl` (pour une écriture de droite à gauche), `scrollLeft` est à `0` lorsque la barre de défilement est à la position la plus à droite possible (ce qui correspond au début du contenu à faire défiler) et elle devient de plus en plus négative lors du défilement vers la fin du contenu. -### Syntaxe +Cette propriété peut être définie avec n'importe quelle valeur entière. Toutefois : - // Obtient le nombre de pixels défilés - var sLeft = element.scrollLeft; +- Si l'élément ne peut pas défiler (par exemple parce qu'il n'y a aucun défilement), `scrollLeft` sera fixée à `0`. +- Si la valeur fournie est inférieure à `0` (ou supérieure à `0` pour les éléments écrits de droite à gauche), `scrollLeft` sera fixée à `0`. +- Si la valeur fournie est supérieure au défilement maximal possible pour le contenu, `scrollLeft` sera fixée à la valeur maximale possible. -_sLeft_ est un entier représentant le nombre de pixels dont _element_ a été défilé vers la gauche. +> **Attention :** Pour les systèmes qui utilisent une mise à l'échelle pour l'affichage (display scaling), `scrollLeft` pourra fournir une valeur décimale. - // Définit le nombre de pixels défilés - element.scrollLeft = 10; +## Valeur -**scrollLeft** peut être n'importe quelle valeur entière, cependant : +Un nombre -- Si l'élément ne peut pas défiler (par exemple parce qu'il ne déborde pas), `scrollLeft` est mis à 0. -- S'il reçoit une valeur inférieure à 0, `scrollLeft` est mis à 0. -- S'il reçoit une valeur plus grande que le maximum dont le contenu peut défiler, `scrollLeft` est mis au maximum. +## Exemples -### Exemple +### HTML ```html - +### CSS -
- -
-
- + +#content { + width: 250px; + background-color: #ccc; +} +``` + +### JavaScript + +```js +const button = document.getElementById('slide'); + +button.onclick = function () { + document.getElementById('container').scrollLeft += 20; +}; ``` -### Spécification +### Résultat + +{{EmbedLiveSample("")}} + +## Spécifications + +{{Specifications}} + +## Compatibilité des navigateurs -{{ DOM0() }} +{{Compat}} -### Références +## Voir aussi -- [_scrollLeft_ sur MSDN](http://msdn.microsoft.com/workshop/author/dhtml/reference/properties/scrollleft.asp) +- [`Element.scrollTop`](/fr/docs/Web/API/Element/scrollTop) +- [`Element.scrollTo()`](/fr/docs/Web/API/Element/scrollTo) From 4af344bb349c324cfdfc0310da8780070b50d179 Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 11:00:12 +0200 Subject: [PATCH 02/27] update onblur vs en-US --- .../api/globaleventhandlers/onblur/index.md | 74 +++++++++++-------- 1 file changed, 42 insertions(+), 32 deletions(-) diff --git a/files/fr/web/api/globaleventhandlers/onblur/index.md b/files/fr/web/api/globaleventhandlers/onblur/index.md index 286ccc3d95d0eb..37e8449f9fac63 100644 --- a/files/fr/web/api/globaleventhandlers/onblur/index.md +++ b/files/fr/web/api/globaleventhandlers/onblur/index.md @@ -1,59 +1,69 @@ --- -title: element.onblur +title: GlobalEventHandlers.onblur slug: Web/API/GlobalEventHandlers/onblur -tags: - - DOM - - DOM_0 translation_of: Web/API/GlobalEventHandlers/onblur +browser-compat: api.GlobalEventHandlers.onblur --- -{{ ApiRef() }} +{{ApiRef("HTML DOM")}} -### Résumé +La propriété **`onblur`**, rattachée au mixin [`GlobalEventHandlers`](/fr/docs/Web/API/GlobalEventHandlers), est [le gestionnaire d'évènements](/fr/docs/Web/Events/Event_handlers) qui permet de traiter les évènements [`blur`](/fr/docs/Web/API/Element/blur_event). Elle est disponible sur les interfaces [`Element`](/fr/docs/Web/API/Element), [`Document`](/fr/docs/Web/API/Document), et [`Window`](/fr/docs/Web/API/Window). -La propriété **onblur** renvoie le gestionnaire de l'évènement `blur` (perte de focus) pour l'élément courant. +L'évènement `blur` est déclenché lorsqu'un élément perd le focus. -### Syntaxe +> **Note :** Le gestionnaire d'évènement opposé à `onblur` est [`onfocus`](/fr/docs/Web/API/GlobalEventHandlers/onfocus). - element.onblur = nomFonctionUtilisateur; +## Syntaxe -- `nomFonctionUtilisateur` est le nom de la fonction utilisateur préalablement définie, sans les parenthèses ni aucun argument. Il est également possible de déclarer une « fonction anonyme », comme : +```js +target.onblur = refFonction; +``` + +### Valeur - +`refFonction` est un nom de fonction ou une [expression de fonction](/fr/docs/Web/JavaScript/Reference/Operators/function). La fonction reçoit un objet [`FocusEvent`](/fr/docs/Web/API/FocusEvent) comme unique argument. - element.onblur = function() { - alert("Évènement onblur détecté"); - }; +## Exemple -### Exemple +Cet exemple utilise `onblur` et [`onfocus`](/fr/docs/Web/API/GlobalEventHandlers/onfocus) pour changer le texte au s'in d'un élément [``](/fr/docs/Web/HTML/Element/Input). -Lorsqu'une zone de saisie n'est plus active suite à une perte du « focus », une boîte de message (alert) est affichée. +### HTML ```html -
- -
+ +``` - ``` -### Notes +### Résultat + +Essayez de cliquer à l'intérieur et en dehors du champ pour voir son contenu être modifié. + +{{EmbedLiveSample('')}} + +## Spécifications + +{{Specifications}} -L'évènement `blur` se déclenche lors de la perte de focus d'un élément. +## Compatibilité des navigateurs -Microsoft Internet Explorer déclenche l'évènement `blur` sur presque tous les éléments, contrairement aux navigateurs Gecko (dont Firefox) qui ne le déclencheront que sur un nombre limité d'éléments. +{{Compat}} -### Spécification +## Voir aussi -{{ DOM0() }} +- L'évènement [`blur`](/fr/docs/Web/API/Element/blur_event) +- Le gestionnaire d'évènement dual : [`GlobalEventHandlers.onfocus`](/fr/docs/Web/API/GlobalEventHandlers/onfocus) From c2697f33fad2fba6a981370348bce90e1f47c0d5 Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 11:18:16 +0200 Subject: [PATCH 03/27] update onchange vs en-US --- .../api/globaleventhandlers/onchange/index.md | 71 ++++++++++++------- 1 file changed, 45 insertions(+), 26 deletions(-) diff --git a/files/fr/web/api/globaleventhandlers/onchange/index.md b/files/fr/web/api/globaleventhandlers/onchange/index.md index 669a38b5d66326..def86d6b06b0fb 100644 --- a/files/fr/web/api/globaleventhandlers/onchange/index.md +++ b/files/fr/web/api/globaleventhandlers/onchange/index.md @@ -1,43 +1,62 @@ --- -title: element.onchange +title: GlobalEventHandlers.onchange slug: Web/API/GlobalEventHandlers/onchange -tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko translation_of: Web/API/GlobalEventHandlers/onchange +browser-compat: api.GlobalEventHandlers.onchange --- -{{ ApiRef() }} +{{ApiRef("HTML DOM")}} -### Résumé +La propriété **`onchange`**, rattachée au mixin [`GlobalEventHandlers`](/fr/docs/Web/API/GlobalEventHandlers), est [un gestionnaire d'évènements](/fr/docs/Web/Events/Event_handlers) qui permet de traiter les évènements [`change`](/fr/docs/Web/API/HTMLElement/change_event). -La propriété `onchange` définit et renvoie le gestionnaire d'évènement `onChange` (modification) pour l'élément courant. +Les évènements `change` sont déclenchés lorsque la personne valide un changement de valeur dans un contrôle d'un formulaire. Cela peut se produire, par exemple, lors d'un clic à l'extérieur du contrôle ou en utilisant la touche Tab pour passer à un contrôle différent. -### Syntaxe +> **Note :** À la différence de [`oninput`](/fr/docs/Web/API/GlobalEventHandlers/oninput), le gestionnaire d'évènements `onchange` n'est pas nécessairement appelé pour chaque modification de la valeur (`value`) d'un élément. - element.onchange = code de gestion de l'évènement +## Syntaxe -### Notes +```js +target.onchange = refFonction; +``` -Le pseudo code suivant illustre la manière dont le gestionnaire d'évènement `change` est implémenté dans Mozilla : +`refFonction` est un nom de fonction ou une [expression de fonction](/fr/docs/Web/JavaScript/Reference/Operators/function). La fonction reçoit un objet [`Event`](/fr/docs/Web/API/Event) comme unique argument. - control.onfocus = focus; - control.onblur = blur; - function focus () { - original_value = control.value; - } +## Exemple - function blur () { - if (control.value != original_value) - control.onchange(); - } +Dans cet exemple, on affiche dans un journal le nombre de caractères d'un élément [``](/fr/docs/Web/HTML/Element/Input) après chaque modification, une fois que le focus a été retiré du contrôle. -Par conséquent, vous pouvez rencontrer des comportements inattendus dans l'évènement `change` si vous modifiez la valeur du contrôle dans vos propres gestionnaires d'évènements `focus` ou `blur`. De plus, l'évènement `change` se déclenche avant l'évènement `blur`. Ce comportement n'est pas le même que celui d'Internet Explorer. +### HTML -### Specification +```html + +

+``` -{{ DOM0() }} +### JavaScript -### Voir aussi +```js +let input = document.querySelector('input'); +let log = document.getElementById('log'); -- [DOM Level 2: HTML event types](http://www.w3.org/TR/DOM-Level-2-Events/events.html#Events-eventgroupings-htmlevents) — traduction en français (non normative) : [DOM Niveau 2 Events : Les types d'événements HTML](http://www.yoyodesign.org/doc/w3c/dom2-events/events.html#Events-eventgroupings-htmlevents) +input.onchange = handleChange; + +function handleChange(e) { + log.textContent = `La valeur du champ mesure + ${e.target.value.length} caractère(s).`; +} +``` + +### Résultat + +{{EmbedLiveSample("")}} + +## Spécifications + +{{Specifications}} + +## Compatibilité des navigateurs + +{{Compat}} + +## Voir aussi + +- L'évènement [`change`](/fr/docs/Web/API/HTMLElement/change_event) From 95df99705ba558c0ba3882e348d39f23f3ee1fe6 Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 11:33:12 +0200 Subject: [PATCH 04/27] update ondblclick vs en-US --- .../globaleventhandlers/ondblclick/index.md | 87 +++++++++---------- 1 file changed, 41 insertions(+), 46 deletions(-) diff --git a/files/fr/web/api/globaleventhandlers/ondblclick/index.md b/files/fr/web/api/globaleventhandlers/ondblclick/index.md index a4ecb0a523f6ed..92be3127a0f7d7 100644 --- a/files/fr/web/api/globaleventhandlers/ondblclick/index.md +++ b/files/fr/web/api/globaleventhandlers/ondblclick/index.md @@ -1,70 +1,65 @@ --- -title: element.ondblclick +title: GlobalEventHandlers.ondblclick slug: Web/API/GlobalEventHandlers/ondblclick -tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko translation_of: Web/API/GlobalEventHandlers/ondblclick +browser-compat: api.GlobalEventHandlers.ondblclick --- -{{ ApiRef() }} +{{ApiRef("HTML DOM")}} -### Résumé +La propriété **`ondblclick`**, rattachée au mixin [`GlobalEventHandlers`](/fr/docs/Web/API/GlobalEventHandlers), est [un gestionnaire d'évènements](/fr/docs/Web/Events/Event_handlers) qui permet de traiter les évènements [`dblclick`](/fr/docs/Web/API/Element/dblclick_event). -La propriété **ondblclick** renvoie le gestionnaire d'évènement `dblclick` de l'élément courant. +L'évènement `dblclick` est déclenché lorsque la personne double-clique sur un élément. Il est déclenché après deux évènements [`click`](/fr/docs/Web/API/Element/click_event). -### Syntaxe +## Syntaxe - element.ondblclick = nomDeFonction; +```js +target.ondblclick = refFonction; +``` -- `nomDeFonction` est le nom d'une fonction définie par l'utilisateur, sans les parenthèses ni aucun paramètre. Il peut également s'agir d'une déclaration de fonction anonyme, comme : +### Valeur - +`refFonction` est un nom de fonction ou une [expression de fonction](/fr/docs/Web/JavaScript/Reference/Operators/function). La fonction reçoit un objet [`MouseEvent`](/fr/docs/Web/API/MouseEvent) comme unique argument. À l'intérieur de cette fonction, le mot-clé [`this`](/fr/docs/Web/JavaScript/Reference/Operators/this) correspondra à l'élément sur lequel l'évènement a été déclenché. - element.ondblclick = function() { alert("Évènement dblclick détecté"); }; +Seul un gestionnaire `ondblclick` peut être affecté par objet à un instant donné. Si besoin de plus de flexibilité, on pourra utiliser la méthode [`EventTarget.addEventListener()`](/fr/docs/Web/API/EventTarget/addEventListener). -### Exemple +## Exemple -```html - +Cet exemple affiche dans un journal la position des doubles-clics. - -ondblclick event example +### HTML - +```js +let log = document.getElementById('log'); - - - - -Mon élément -

Double-cliquez sur l'élément ci-dessus.

- - ``` -### Notes +### Résultat + +{{EmbedLiveSample("")}} + +## Spécifications + +{{Specifications}} + +## Compatibilité des navigateurs -L'évènement `dblclick` est déclenché lorsque l'utilisateur double-clique sur un élément. +{{Compat}} -### Spécification +## Voir aussi -{{ DOM0() }} +- L'évènement [`dblclick`](/fr/docs/Web/API/Element/dblclick_event) +- Les gestionnaires d'évènements associés + - [`GlobalEventHandlers.onauxclick`](/fr/docs/Web/API/GlobalEventHandlers/onauxclick) + - [`GlobalEventHandlers.onclick`](/fr/docs/Web/API/GlobalEventHandlers/onclick) From 9bb2b124d00ae02d0033b44204e099d3ff58df73 Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 13:07:47 +0200 Subject: [PATCH 05/27] update onfocus vs en-US --- .../api/globaleventhandlers/onfocus/index.md | 74 +++++++++++++++---- 1 file changed, 59 insertions(+), 15 deletions(-) diff --git a/files/fr/web/api/globaleventhandlers/onfocus/index.md b/files/fr/web/api/globaleventhandlers/onfocus/index.md index f8b2de65f524ad..c2deb458600dea 100644 --- a/files/fr/web/api/globaleventhandlers/onfocus/index.md +++ b/files/fr/web/api/globaleventhandlers/onfocus/index.md @@ -1,28 +1,72 @@ --- -title: element.onfocus +title: GlobalEventHandlers.onfocus slug: Web/API/GlobalEventHandlers/onfocus -tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko translation_of: Web/API/GlobalEventHandlers/onfocus +browser-compat: api.GlobalEventHandlers.onfocus --- -{{ ApiRef() }} +{{ApiRef("HTML DOM")}} -### Résumé +La propriété **`onfocus`**, , rattachée au mixin [`GlobalEventHandlers`](/fr/docs/Web/API/GlobalEventHandlers), est [un gestionnaire d'évènements](/fr/docs/Web/Events/Event_handlers) qui permet de traiter les évènements [`focus`](/fr/docs/Web/API/Element/focus_event). -La propriété **onfocus** renvoie le gestionnaire de l'évènement `focus` pour l'élément courant. +L'évènement `focus` est déclenché lorsque la personne active le focus sur un élément. -### Syntaxe +Afin que `onfocus` soit déclenché sur les éléments qui ne sont pas des éléments ``, il faut que ces derniers aient un attribut [`tabindex`](/fr/docs/Web/HTML/Global_attributes#attr-tabindex). Voir la section [Remettre l'accessibilité au clavier](/fr/docs/Learn/Accessibility/HTML#remettre_laccessibilité_au_clavier) pour plus de détails. - code de gestion de l'évènement = element.onfocus +> **Note :** Le gestionnaire d'évènement opposé à `onfocus` est [`onblur`](/fr/docs/Web/API/GlobalEventHandlers/onblur). -### Notes +## Syntaxe -L'évènement focus se déclenche lorsque l'utilisateur donne le focus clavier à l'élément donné. +```js +cible.onfocus = refFonction; +``` -Contrairement à Microsoft Internet Explorer, dans lequel presque toutes les sortes d'éléments peuvent recevoir l'évènement focus, presqu'aucune sorte d'élément ne reçoit cet évènement dans les navigateurs utilisant Gecko. +### Value -### Spécification +`refFonction` est un nom de fonction ou une [expression de fonction](/fr/docs/Web/JavaScript/Reference/Operators/function). La fonction reçoit un objet [`FocusEvent`](/fr/docs/Web/API/FocusEvent) comme unique argument. -{{ DOM0() }} +## Exemple + +Cet exemple utilise [`onblur`](/fr/docs/Web/API/GlobalEventHandlers/onblur) et `onfocus` pour changer le texte au sein d'un élément [``](/fr/docs/Web/HTML/Element/Input). + + +### HTML + +```html + +``` + +### JavaScript + +```js +let input = document.querySelector('input'); + +input.onblur = inputBlur; +input.onfocus = inputFocus; + +function inputBlur() { + input.value = 'Le focus a été perdu'; +} + +function inputFocus() { + input.value = 'Le focus est là'; +} +``` + +### Résultat + +Essayez de cliquer à l'intérieur et en dehors du champ pour voir son contenu être modifié. + +{{EmbedLiveSample('')}} + +## Spécifications + +{{Specifications}} + +## Compatibilité des navigateurs + +{{Compat}} + +## Voir aussi + +- L'évènement [`focus`](/fr/docs/Web/API/Element/focus_event) +- Le gestionnaire d'évènement dual : [`GlobalEventHandlers.onblur`](/fr/docs/Web/API/GlobalEventHandlers/onblur) From 899a77990a318547caf6a511ed85995c348676ed Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 13:08:03 +0200 Subject: [PATCH 06/27] fix typo --- files/fr/web/api/globaleventhandlers/onblur/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/fr/web/api/globaleventhandlers/onblur/index.md b/files/fr/web/api/globaleventhandlers/onblur/index.md index 37e8449f9fac63..51e0efa0fbb3ba 100644 --- a/files/fr/web/api/globaleventhandlers/onblur/index.md +++ b/files/fr/web/api/globaleventhandlers/onblur/index.md @@ -24,7 +24,7 @@ target.onblur = refFonction; ## Exemple -Cet exemple utilise `onblur` et [`onfocus`](/fr/docs/Web/API/GlobalEventHandlers/onfocus) pour changer le texte au s'in d'un élément [``](/fr/docs/Web/HTML/Element/Input). +Cet exemple utilise `onblur` et [`onfocus`](/fr/docs/Web/API/GlobalEventHandlers/onfocus) pour changer le texte au sein d'un élément [``](/fr/docs/Web/HTML/Element/Input). ### HTML From 8f67859a4205ba0aa1b5cc1b2525cdc42027ad6b Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 13:08:37 +0200 Subject: [PATCH 07/27] target > source --- files/fr/web/api/globaleventhandlers/onblur/index.md | 2 +- files/fr/web/api/globaleventhandlers/onchange/index.md | 2 +- files/fr/web/api/globaleventhandlers/ondblclick/index.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/files/fr/web/api/globaleventhandlers/onblur/index.md b/files/fr/web/api/globaleventhandlers/onblur/index.md index 51e0efa0fbb3ba..15f6dfab96f185 100644 --- a/files/fr/web/api/globaleventhandlers/onblur/index.md +++ b/files/fr/web/api/globaleventhandlers/onblur/index.md @@ -15,7 +15,7 @@ L'évènement `blur` est déclenché lorsqu'un élément perd le focus. ## Syntaxe ```js -target.onblur = refFonction; +cible.onblur = refFonction; ``` ### Valeur diff --git a/files/fr/web/api/globaleventhandlers/onchange/index.md b/files/fr/web/api/globaleventhandlers/onchange/index.md index def86d6b06b0fb..33b104964a1d9d 100644 --- a/files/fr/web/api/globaleventhandlers/onchange/index.md +++ b/files/fr/web/api/globaleventhandlers/onchange/index.md @@ -15,7 +15,7 @@ Les évènements `change` sont déclenchés lorsque la personne valide un change ## Syntaxe ```js -target.onchange = refFonction; +cible.onchange = refFonction; ``` `refFonction` est un nom de fonction ou une [expression de fonction](/fr/docs/Web/JavaScript/Reference/Operators/function). La fonction reçoit un objet [`Event`](/fr/docs/Web/API/Event) comme unique argument. diff --git a/files/fr/web/api/globaleventhandlers/ondblclick/index.md b/files/fr/web/api/globaleventhandlers/ondblclick/index.md index 92be3127a0f7d7..7f532eb9174d13 100644 --- a/files/fr/web/api/globaleventhandlers/ondblclick/index.md +++ b/files/fr/web/api/globaleventhandlers/ondblclick/index.md @@ -13,7 +13,7 @@ L'évènement `dblclick` est déclenché lorsque la personne double-clique sur u ## Syntaxe ```js -target.ondblclick = refFonction; +cible.ondblclick = refFonction; ``` ### Valeur From c3eee0ec56db3a4e1fe0f4eebc5551276c0683a6 Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 13:17:18 +0200 Subject: [PATCH 08/27] update onkeydown vs en-US --- .../globaleventhandlers/onkeydown/index.md | 79 +++++++++++++++---- 1 file changed, 62 insertions(+), 17 deletions(-) diff --git a/files/fr/web/api/globaleventhandlers/onkeydown/index.md b/files/fr/web/api/globaleventhandlers/onkeydown/index.md index b280fea9ad9280..549accfdf68363 100644 --- a/files/fr/web/api/globaleventhandlers/onkeydown/index.md +++ b/files/fr/web/api/globaleventhandlers/onkeydown/index.md @@ -1,32 +1,77 @@ --- -title: element.onkeydown +title: GlobalEventHandlers.onkeydown slug: Web/API/GlobalEventHandlers/onkeydown -tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko translation_of: Web/API/GlobalEventHandlers/onkeydown +browser-compat: api.GlobalEventHandlers.onkeydown --- -{{ ApiRef() }} +{{ApiRef("HTML DOM")}} -### Résumé +La propriété **`onkeydown`**, rattachée au mixin [`GlobalEventHandlers`](/fr/docs/Web/API/GlobalEventHandlers), est [un gestionnaire d'évènements](/fr/docs/Web/Events/Event_handlers) qui permet de traiter les évènements [`keydown`](/fr/docs/Web/API/Document/keydown_event). -La propriété **onkeydown** définit et renvoie le gestionnaire d'évènement `keydown` de l'élément courant. +L'évènement `keydown` est déclenché lorsque l'utilisatrice ou l'utilisateur appuie sur une touche du clavier. -### Syntaxe +## Syntaxe - code de gestion de l'évènement = element.onkeydown +```js +cible.onkeydown = refFunction; +``` -### Notes +### Value -L'évènement `keydown` se déclenche lorsque qu'une touche du clavier est enfoncée. +`refFunction` est un nom de fonction ou une [expression de fonction](/fr/docs/Web/JavaScript/Reference/Operators/function). La fonction reçoit un objet [`KeyboardEvent`](/fr/docs/Web/API/KeyboardEvent) comme unique argument. -À différencier de [onkeypress](/fr/DOM/element.onkeypress) qui se déclenche lorsque qu'une touche du clavier est pressée. (La nuance se situe dans le fait que `onkeydown` se produit avant `onkeypress` même s'ils se produisent quasiment au même instant) +## Exemple -### Voir aussi +Cet exemple affiche la valeur de [`KeyboardEvent.code`](/fr/docs/Web/API/KeyboardEvent/code) à chaque fois qu'on appuie sur une touche à l'intérieur de l'élément [``](/fr/docs/Web/HTML/Element/Input). -[onkeypress](/fr/DOM/element.onkeypress) [onkeyup](/fr/DOM/element.onkeyup) +### HTML -### Spécification +```html + +

+``` -{{ DOM0() }} +### JavaScript + +```js +const input = document.querySelector('input'); +const log = document.getElementById('log'); + +input.onkeydown = logKey; + +function logKey(e) { + log.textContent += ` ${e.code}`; +} +``` + +### Résultat + +{{EmbedLiveSample("")}} + +## Spécifications + +{{Specifications}} + +## Compatibilité des navigateurs + +{{Compat}} + +### Notes de compatibilité + +Depuis Firefox 65, les évènements [`keyup`](/fr/docs/Web/API/Document/keyup_event) et [`keydown`](/fr/docs/Web/API/Document/keydown_event) sont désormais déclenchés pendant la composition IME afin d'améliorer la compatibilité entre les navigateurs pour les locuteurs de langues asiatiques (CJKT) (voir [le bug 354358](https://bugzilla.mozilla.org/show_bug.cgi?id=354358)). Pour ignorer les évènements `keydown` qui font partie d'une composition, on pourra écrire quelque chose d'analogue au fragment qui suit (229 est une valeur spéciale de `keyCode` relative à un évènement qui a été traité par un IME) : + +```js +eventTarget.addEventListener("keydown", event => { + if (event.isComposing || event.keyCode === 229) { + return; + } + // faire quelque chose +}); +``` + +## Voir aussi + +- L'évènement [`keydown`](/fr/docs/Web/API/Document/keydown_event) +- Les gestionnaires d'évènements associés + - [`GlobalEventHandlers.onkeypress`](/fr/docs/Web/API/GlobalEventHandlers/onkeypress) + - [`GlobalEventHandlers.onkeyup`](/fr/docs/Web/API/GlobalEventHandlers/onkeyup) From 6e7dc4333085889fe10df1a046e98ba31bd7c663 Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 14:07:07 +0200 Subject: [PATCH 09/27] update onkeypress vs en-US --- .../globaleventhandlers/onkeypress/index.md | 145 ++++++++++++++++-- 1 file changed, 128 insertions(+), 17 deletions(-) diff --git a/files/fr/web/api/globaleventhandlers/onkeypress/index.md b/files/fr/web/api/globaleventhandlers/onkeypress/index.md index 42a8889bf90113..62c5772a883235 100644 --- a/files/fr/web/api/globaleventhandlers/onkeypress/index.md +++ b/files/fr/web/api/globaleventhandlers/onkeypress/index.md @@ -1,32 +1,143 @@ --- -title: element.onkeypress +title: GlobalEventHandlers.onkeypress slug: Web/API/GlobalEventHandlers/onkeypress -tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko translation_of: Web/API/GlobalEventHandlers/onkeypress +browser-compat: api.GlobalEventHandlers.onkeypress --- -{{ ApiRef() }} +{{ApiRef("HTML DOM")}} {{deprecated_header}} -### Résumé +La propriété **`onkeypress`**, rattachée au mixin [`GlobalEventHandlers`](/fr/docs/Web/API/GlobalEventHandlers), est [un gestionnaire d'évènements](/fr/docs/Web/Events/Event_handlers) qui permet de traiter les évènements [`keypress`](/fr/docs/Web/API/Document/keypress_event). -La propriété **onkeypress** définit et renvoie le gestionnaire d'évènement `keypress` de l'élément courant. +L'évènement `keypress` _devrait_ être déclenché lorsqu'on appuie sur une touche du clavier. Toutefois, en pratique, les navigateurs ne déclenchent pas d'évènements `keypress` pour certaines touches. -### Syntaxe +> **Attention :** Le gestionnaire d'évènements `onkeypress` est déprécié, il faut utiliser [`onkeydown`](/fr/docs/Web/API/GlobalEventHandlers/onkeydown) à la place. - element.onkeypress = code de gestion de l'évènement +## Syntaxe -### Notes +```js +cible.onkeypress = refFonction; +``` -L'évènement `keypress` se déclenche lorsque qu'une touche du clavier est pressée. +### Valeur -À différencier de [onkeydown](/fr/DOM/element.onkeydown) qui se déclenche lorsque qu'une touche du clavier est enfoncée. (La nuance se situe dans le fait que `onkeydown` se produit avant `onkeypress`, même s'il se produisent quasiment au même instant) +`refFonction` est un nom de fonction ou une [expression de fonction](/fr/docs/Web/JavaScript/Reference/Operators/function). La fonction reçoit un objet [`KeyboardEvent`](/fr/docs/Web/API/KeyboardEvent) comme unique argument. -### Voir aussi +## Exemples -[onkeydown](/fr/DOM/element.onkeydown) [onkeyup](/fr/DOM/element.onkeyup) +### Exemple simple -### Spécification +Cet exemple affiche la valeur de [`KeyboardEvent.code`](/fr/docs/Web/API/KeyboardEvent/code) à chaque fois qu'on appuie sur une touche à l'intérieur de l'élément [``](/fr/docs/Web/HTML/Element/Input). -{{ DOM0() }} +#### HTML + +```html + +

+``` + +#### JavaScript + +```js +const input = document.querySelector('input'); +const log = document.getElementById('log'); + +input.onkeypress = logKey; + +function logKey(e) { + log.textContent += ` ${e.code}`; +} +``` + +#### Résultat + +{{EmbedLiveSample("", 700, 200)}} + +### Filtrer des touches à l'aide d'une expression rationnelle + +Dans cet exemple, on filtre les caractères saisis dans le champ du formulaire à l'aide d'une [expression rationnelle](/fr/docs/Web/JavaScript/Guide/Regular_Expressions). + +#### HTML + +```html + +``` + +#### JavaScript + +```js +function numbersOnly(event) { + return event.charCode === 0 || /\d/.test(String.fromCharCode(event.charCode)); +} + +const input = document.querySelector('input'); +input.onkeypress = numbersOnly; + +// On empêche de coller (le contenu collé pourrait contenir +// des caractères qui ne sont pas des chiffres) +input.onpaste = event => false; +``` + +#### Résultat + +{{EmbedLiveSample("")}} + +### Capturer la saisie d'un mot-clé secret + +La fonction JavaScript qui suit fera une action lorsqu'on saisira le mot "exit" à n'importe quel endroit de la page. + +```js + +(function () { + const sSecret = "exit"; + let nOffset = 0; + + document.onkeypress = function(oPEvt) { + let oEvent = oPEvt || window.event, + nChr = oEvent.charCode, + sNodeType = oEvent.target.nodeName.toUpperCase(); + + if (nChr === 0 || + oEvent.target.contentEditable.toUpperCase() === "TRUE" || + sNodeType === "TEXTAREA" || + sNodeType === "INPUT" && oEvent.target.type.toUpperCase() === "TEXT") { + return true; + } + + if (nChr !== sSecret.charCodeAt(nOffset)) { + nOffset = nChr === sSecret.charCodeAt(0) ? 1 : 0; + } else if (nOffset < sSecret.length - 1) { + nOffset++; + } else { + nOffset = 0; + /* Faire quelque chose ici… */ + console.log("et voilà !"); + location.assign("https://developer.mozilla.org/"); + } + + return true; + }; +})(); +``` + +> **Note :** Un framework pour effectuer de telles captures, plus complet, est [disponible sur GitHub](https://github.com/madmurphy/spell.js/). + +## Spécifications + +{{Specifications}} + +## Compatibilité des navigateurs + +{{Compat}} + +### Notes de compatibilité + +- L'évènement `keypress` n'est plus déclenché pour [les touches non-imprimables](/fr/docs/Web/API/KeyboardEvent/keyCode#non-printable_keys_(function_keys)) (voir [le bug 968056](https://bugzilla.mozilla.org/show_bug.cgi?id=968056) pour l'implémentation de ce comportement dans Firefox 65), à l'exception de la touche Entrée, et des combinaisons de touches Shift+Entrée et Ctrl+Entrée (à des fins de compatibilité entre navigateurs). + +## Voir aussi + +- L'évènement [`keypress`](/fr/docs/Web/API/Document/keypress_event) +- Les gestionnaires d'évènements associés + - [`GlobalEventHandlers.onkeydown`](/fr/docs/Web/API/GlobalEventHandlers/onkeydown) + - [`GlobalEventHandlers.onkeyup`](/fr/docs/Web/API/GlobalEventHandlers/onkeyup) From 4c2c6d46546eac9ebf08dfc295f0e6072d9d6090 Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 14:22:35 +0200 Subject: [PATCH 10/27] update onmousedown vs en-US --- .../globaleventhandlers/onmousedown/index.md | 103 +++++++++++++++--- 1 file changed, 89 insertions(+), 14 deletions(-) diff --git a/files/fr/web/api/globaleventhandlers/onmousedown/index.md b/files/fr/web/api/globaleventhandlers/onmousedown/index.md index 77e14f71e0801d..baf1f9ae38e59a 100644 --- a/files/fr/web/api/globaleventhandlers/onmousedown/index.md +++ b/files/fr/web/api/globaleventhandlers/onmousedown/index.md @@ -1,26 +1,101 @@ --- -title: element.onmousedown +title: GlobalEventHandlers.onmousedown slug: Web/API/GlobalEventHandlers/onmousedown -tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko translation_of: Web/API/GlobalEventHandlers/onmousedown +browser-compat: api.GlobalEventHandlers.onmousedown --- -{{ ApiRef() }} +{{ApiRef("HTML DOM")}} -### Résumé +La propriété **`onmousedown`**, rattachée au mixin [`GlobalEventHandlers`](/fr/docs/Web/API/GlobalEventHandlers), est [un gestionnaire d'évènements](/fr/docs/Web/Events/Event_handlers) qui permet de traiter les évènements [`mousedown`](/fr/docs/Web/API/Element/mousedown_event). -La propriété **onmousedown** renvoie le gestionnaire de l'évènement `mousedown` (bouton de la souris enfoncé) pour l'élément courant. +L'évènement `mousedown` est déclenché lorsqu'on appuie sur le bouton de la souris. -### Syntaxe +> **Note :** Le gestionnaire d'évènements opposé à `onmousedown` est [`onmouseup`](/fr/docs/Web/API/GlobalEventHandlers/onmouseup). - code de gestion de l'évènement = element.onMouseDown +## Syntaxe -### Notes +```js +cible.onmousedown = refFonction; +``` -L'évènement `mousedown` se déclenche lorsque l'utilisateur appuie sur le bouton gauche de la souris. +### Value -### Spécification +`refFonction` est un nom de fonction ou une [expression de fonction](/fr/docs/Web/JavaScript/Reference/Operators/function). La fonction reçoit un objet [`MouseEvent`](/fr/docs/Web/API/MouseEvent) comme unique argument. -{{ DOM0() }} +## Exemple + +Cet exemple révèle une partie d'une image lorsqu'on appuie et maintient un bouton de souris. Il utilise les gestionnaires d'évènements `onmousedown`, [`onmouseup`](/fr/docs/Web/API/GlobalEventHandlers/onmouseup), et [`onmousemove`](/fr/docs/Web/API/GlobalEventHandlers/onmousemove). + +### HTML + +```html +
+ + +
+``` + +### CSS + +```css +.container { + width: 300px; + height: 227px; + background: black; +} + +.view { + position: absolute; + width: 100px; + height: 100px; + background: white; + border-radius: 50%; +} + +img { + mix-blend-mode: darken; +} +``` + +### JavaScript + +```js +function showView(event) { + view.removeAttribute('hidden'); + view.style.left = event.clientX - 50 + 'px'; + view.style.top = event.clientY - 50 + 'px'; + event.preventDefault(); +} + +function moveView(event) { + view.style.left = event.clientX - 50 + 'px'; + view.style.top = event.clientY - 50 + 'px'; +} + +function hideView(event) { + view.setAttribute('hidden', ''); +} + +const container = document.querySelector('.container'); +const view = document.querySelector('.view'); + +container.onmousedown = showView; +container.onmousemove = moveView; +document.onmouseup = hideView; +``` + +### Résultat + +{{EmbedLiveSample("", 700, 300)}} + +## Spécifications + +{{Specifications}} + +## Compatibilité des navigateurs + +{{Compat}} + +## Voir aussi + +- L'évènement [`mousedown`](/fr/docs/Web/API/Element/mousedown_event) From ff5eed75917c2e7d6afe78e2615250339c90e7f6 Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 14:25:15 +0200 Subject: [PATCH 11/27] typofix --- files/fr/web/api/globaleventhandlers/onmousedown/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/fr/web/api/globaleventhandlers/onmousedown/index.md b/files/fr/web/api/globaleventhandlers/onmousedown/index.md index baf1f9ae38e59a..8b48e177bc1e2e 100644 --- a/files/fr/web/api/globaleventhandlers/onmousedown/index.md +++ b/files/fr/web/api/globaleventhandlers/onmousedown/index.md @@ -18,7 +18,7 @@ L'évènement `mousedown` est déclenché lorsqu'on appuie sur le bouton de la s cible.onmousedown = refFonction; ``` -### Value +### Valeur `refFonction` est un nom de fonction ou une [expression de fonction](/fr/docs/Web/JavaScript/Reference/Operators/function). La fonction reçoit un objet [`MouseEvent`](/fr/docs/Web/API/MouseEvent) comme unique argument. From 91215f646ab907d2a54adbd24798a12d39edf21a Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 14:30:13 +0200 Subject: [PATCH 12/27] update onmousemove vs en-US --- .../globaleventhandlers/onmousemove/index.md | 99 +++++++++++++++---- 1 file changed, 78 insertions(+), 21 deletions(-) diff --git a/files/fr/web/api/globaleventhandlers/onmousemove/index.md b/files/fr/web/api/globaleventhandlers/onmousemove/index.md index 07ecef1a1ee8f5..640610050d5743 100644 --- a/files/fr/web/api/globaleventhandlers/onmousemove/index.md +++ b/files/fr/web/api/globaleventhandlers/onmousemove/index.md @@ -1,39 +1,96 @@ --- -title: element.onmousemove +title: GlobalEventHandlers.onmousemove slug: Web/API/GlobalEventHandlers/onmousemove -tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko translation_of: Web/API/GlobalEventHandlers/onmousemove +browser-compat: api.GlobalEventHandlers.onmousemove --- -{{ ApiRef() }} +{{ApiRef("HTML DOM")}} -### Résumé +La propriété **`onmousemove`**, rattachée au mixin [`GlobalEventHandlers`](/fr/docs/Web/API/GlobalEventHandlers), est [un gestionnaire d'évènements](/fr/docs/Web/Events/Event_handlers) qui permet de traiter les évènements [`mousemove`](/fr/docs/Web/API/Element/mousemove_event). -La propriété **onmousemove** renvoie le code de gestion de l'évènement `mousemove` pour l'élément courant. +Un évènement `mousemove` est déclenché lorsqu'on déplace la souris. -### Syntax +## Syntaxe -`element.onmousemove = functionRef` +```js +cible.onmousemove = refFonction; +``` -où _functionRef_ est une fonction ou une expression de type _function._ Consulter la [référence des fonctions](/en-US/docs/JavaScript/Reference/Functions_and_function_scope) pour plus de détails. +### Valeur -Le paramètre fournit au gestionnaire d'évènement _functionRef_ lors du déclenchement de l'évènement est objet qui représente l'évènement de déplacment de souris, de type {{ domxref("MouseEvent") }}. +`refFonction`est un nom de fonction ou une [expression de fonction](/fr/docs/Web/JavaScript/Reference/Operators/function). La fonction reçoit un objet [`MouseEvent`](/fr/docs/Web/API/MouseEvent) comme unique argument. -### Exemple +## Exemples -```js -document.body.onmousemove = event => { - // Suivi de la position de la souris dans la console - console.log(`Position de la souris : X = ${event.clientX} | Y = ${event.clientY}`); +### Bulles d'information + +Cet exemple crée des bulles d'information qui suivent la souris. Il utilise les gestionnaires d'évènements `onmousemove`, [`onmouseover`](/fr/docs/Web/API/GlobalEventHandlers/onmouseover), et [`onmouseout`](/fr/docs/Web/API/GlobalEventHandlers/onmouseout). + +#### HTML + +```html +

Voir une bulle d'information ici…

+

… ou ici !

+``` + +#### CSS + +```css +.tooltip { + position: absolute; + z-index: 9999; + padding: 6px; + background: #ffd; + border: 1px #886 solid; + border-radius: 5px; } ``` -### Notes +#### JavaScript + +```js +const tooltip = new (function() { + const node = document.createElement('div'); + node.className = 'tooltip'; + node.setAttribute('hidden', ''); + document.body.appendChild(node); + + this.follow = function(event) { + node.style.left = event.clientX + 20 + 'px'; + node.style.top = event.clientY + 10 + 'px'; + }; + + this.show = function(event) { + node.textContent = event.target.dataset.tooltip; + node.removeAttribute('hidden'); + }; + + this.hide = function() { + node.setAttribute('hidden', ''); + }; +})(); + +const links = document.querySelectorAll('a'); + +links.forEach(link => { + link.onmouseover = tooltip.show; + link.onmousemove = tooltip.follow; + link.onmouseout = tooltip.hide; +}); +``` + +#### Résultat + +{{EmbedLiveSample("")}} + +## Spécifications + +{{Specifications}} + +## Compatibilité des navigateurs -L'évènement `mousemove` se déclenche lorsque l'utilisateur déplace la souris. +{{Compat}} -### Spécification +## Voir aussi -{{ DOM0() }} +- L'évènement [`mousemove`](/fr/docs/Web/API/Element/mousemove_event) From fede3020a56fe0e6cbdd56b930748eabf549a6d8 Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 14:42:50 +0200 Subject: [PATCH 13/27] update onmouseout vs en-US --- .../globaleventhandlers/onmouseout/index.md | 61 ++++++++++++++----- 1 file changed, 47 insertions(+), 14 deletions(-) diff --git a/files/fr/web/api/globaleventhandlers/onmouseout/index.md b/files/fr/web/api/globaleventhandlers/onmouseout/index.md index 8574ace6b64f17..3223ef2a913a36 100644 --- a/files/fr/web/api/globaleventhandlers/onmouseout/index.md +++ b/files/fr/web/api/globaleventhandlers/onmouseout/index.md @@ -1,26 +1,59 @@ --- -title: element.onmouseout +title: GlobalEventHandlers.onmouseout slug: Web/API/GlobalEventHandlers/onmouseout -tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko translation_of: Web/API/GlobalEventHandlers/onmouseout +browser-compat: api.GlobalEventHandlers.onmouseout --- -{{ ApiRef() }} +{{ApiRef("HTML DOM")}} -### Résumé +La propriété **`onmouseout`**, rattachée au mixin [`GlobalEventHandlers`](/fr/docs/Web/API/GlobalEventHandlers), est [un gestionnaire d'évènements](/fr/docs/Web/Events/Event_handlers) qui permet de traiter les évènements [`mouseout`](/fr/docs/Web/API/Element/mouseout_event). -La propriété **onmouseout** renvoie le code de gestion de l'évènement `mouseout` (sortie du pointeur de la souris) pour l'élément courant. +Un évènement `mouseout` est déclenché lorsque la souris quitte un élément. Par exemple, si la souris se déplace en dehors d'une image d'une page web, l'évènement `mouseout` est déclenché pour cet élément d'image. -### Syntaxe +## Syntaxe - code de gestion de l'évènement = element.onmouseout +```js +cible.onmouseout = refFonction; +``` -### Notes +### Valeur -L'évènement `mouseout` se déclenche lorsque le pointeur de la souris quitte un élément (par exemple lorsque le pointeur sort d'une image sur une page web, cet évènement se déclenche pour l'élément `image` correspondant). +`refFonction`est un nom de fonction ou une [expression de fonction](/fr/docs/Web/JavaScript/Reference/Operators/function). La fonction reçoit un objet [`MouseEvent`](/fr/docs/Web/API/MouseEvent) comme unique argument. -### Spécification +## Exemple -{{ DOM0() }} +Cet exemple ajoute des gestionnaires d'évènements `onmouseout` et `onmouseover` sur un paragraphe. Essayez de déplacer votre souris sur le paragraphe et en dehors. + +### HTML + +```html +

Testez votre souris ici !

+``` + +### JavaScript + +```js +const p = document.querySelector('p'); +p.onmouseover = logMouseOver; +p.onmouseout = logMouseOut; + +function logMouseOver() { + p.textContent = 'évènement mouseover détecté'; +} + +function logMouseOut() { + p.textContent = 'évènement mouseout détecté'; +} +``` + +### Résultat + +{{EmbedLiveSample("")}} + +## Spécifications + +{{Specifications}} + +## Compatibilité des navigateurs + +{{Compat}} From 3d8a0a6eba9923524224c8bafbaf607276e417eb Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 14:52:48 +0200 Subject: [PATCH 14/27] update onmouseup vs en-US --- .../globaleventhandlers/onmouseup/index.md | 108 +++++++++++++++--- 1 file changed, 94 insertions(+), 14 deletions(-) diff --git a/files/fr/web/api/globaleventhandlers/onmouseup/index.md b/files/fr/web/api/globaleventhandlers/onmouseup/index.md index 766da9723ddde2..ef47d94e7ad5a2 100644 --- a/files/fr/web/api/globaleventhandlers/onmouseup/index.md +++ b/files/fr/web/api/globaleventhandlers/onmouseup/index.md @@ -1,26 +1,106 @@ --- -title: element.onmouseup +title: GlobalEventHandlers.onmouseup slug: Web/API/GlobalEventHandlers/onmouseup -tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko translation_of: Web/API/GlobalEventHandlers/onmouseup +browser-compat: api.GlobalEventHandlers.onmouseup --- -{{ ApiRef() }} +{{ApiRef("HTML DOM")}} -### Résumé +La propriété **`onmouseup`**, rattachée au mixin [`GlobalEventHandlers`](/fr/docs/Web/API/GlobalEventHandlers), est [un gestionnaire d'évènements](/fr/docs/Web/Events/Event_handlers) qui permet de traiter les évènements [`mouseup`](/fr/docs/Web/API/Element/mouseup_event). -La propriété **onmouseup** renvoie le gestionnaire de l'évènement `mouseup` (bouton de la souris relaché) pour l'élément courant. +Un évènement `mouseup` se produit lorsqu'on relâche le bouton de la souris. -### Syntaxe +> **Note :** Le gestionnaire d'évènements opposé à `onmouseup` est [`onmousedown`](/fr/docs/Web/API/GlobalEventHandlers/onmousedown). - code de gestion de l'évènement = element.onMouseUp +## Syntaxe -### Notes +```js +cible.onmouseup = refFonction; +``` -L'évènement `mouseup` se déclenche lorsque l'utilisateur relâche le bouton gauche de la souris. +### Valeur -### Spécification +`refFonction` est un nom de fonction ou une [expression de fonction](/fr/docs/Web/JavaScript/Reference/Operators/function). La fonction reçoit un objet [`MouseEvent`](/fr/docs/Web/API/MouseEvent) comme unique argument. -{{ DOM0() }} +## Exemple + +Dans cet exemple, une « tartine » se cache lorsqu'on clique avec la souris sur le grille-pain puis réapparaît lorsqu'on relâche le bouton. L'exemple utilise les gestionnaires d'évènements [`onmousedown`](/fr/docs/Web/API/GlobalEventHandlers/onmousedown) et `onmouseup`. + +### HTML + +```html +
+
+
Coucou le monde !
+
+``` + +### CSS + +```css +.container { + position: absolute; + left: 50%; + bottom: 20px; + transform: translate(-50%); +} + +.toaster { + width: 160px; + height: 110px; + background: #bbb; + border-radius: 10px 10px 0 0; +} + +.toast { + position: absolute; + left: 50%; + top: 50%; + z-index: -1; + width: 100px; + height: 50px; + padding: 10px; + background: #ed9; + border-radius: 10px 10px 0 0; + transform: translate(-50%, -90px); + transition: transform .3s; +} + +.depressed { + transform: translate(-50%, -50%); +} +``` + +### JavaScript + +```js +function depress() { + toast.classList.add('depressed'); +} + +function release() { + toast.classList.remove('depressed'); +} + +const toaster = document.querySelector('.toaster'); +const toast = document.querySelector('.toast'); + +toaster.onmousedown = depress; +document.onmouseup = release; +``` + +### Résultat + +{{EmbedLiveSample("", 700, 200)}} + +## Spécifications + +{{Specifications}} + +## Compatibilité des navigateurs + +{{Compat}} + +## Voir aussi + +- L'évènement [`mouseup`](/fr/docs/Web/API/Element/mouseup_event) From d5ffcbadaa64a614ccf5e981eb5d6925f3c4d943 Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 14:59:12 +0200 Subject: [PATCH 15/27] update onresize vs en-US --- .../api/globaleventhandlers/onresize/index.md | 84 +++++++++---------- 1 file changed, 41 insertions(+), 43 deletions(-) diff --git a/files/fr/web/api/globaleventhandlers/onresize/index.md b/files/fr/web/api/globaleventhandlers/onresize/index.md index b18387cce12189..f65acb42955c2d 100644 --- a/files/fr/web/api/globaleventhandlers/onresize/index.md +++ b/files/fr/web/api/globaleventhandlers/onresize/index.md @@ -1,66 +1,64 @@ --- -title: element.onresize +title: GlobalEventHandlers.onresize slug: Web/API/GlobalEventHandlers/onresize -tags: - - DOM - - DOM_0 translation_of: Web/API/window.onresize translation_of_original: Web/API/Element.onresize +browser-compat: api.GlobalEventHandlers.onresize --- -{{ ApiRef() }} +{{ApiRef}} -### Résumé +La propriété **`onresize`**,rattachée au mixin [`GlobalEventHandlers`](/fr/docs/Web/API/GlobalEventHandlers), est [un gestionnaire d'évènements](/fr/docs/Web/Events/Event_handlers) qui permet de traiter les évènements [`resize`](/fr/docs/Web/API/Window/resize_event). -La propriété **onresize** renvoie le code de gestion `onresize` de l'élément. Il sert également à définir le code devant s'exécuter lorsqu'un évènement de redimensionnement survient. +Un évènement `resize` est déclenché après que la fenêtre a été redimensionnée. -Seul l'objet _window_ possède un évènement `onresize`. +## Syntaxe -### Syntaxe - - // attribue une fonction anonyme à onresize - window.onresize = function(){alert('Redimensionnement de la fenêtre')} +```js +window.onresize = refFonction; +``` - // Attribue la référence d'une fonction à onresize - function sayHi(){alert('Hi')} +### Value - window.onresize = sayHi; +`refFonction` est un nom de fonction ou une [expression de fonction](/fr/docs/Web/JavaScript/Reference/Operators/function). La fonction reçoit un objet [`FocusEvent`](/fr/docs/Web/API/FocusEvent) comme unique argument. - // Montre la valeur de window.onresize - alert(window.onresize); +## Exemple -Un évènement onresize employé avec des cadres sera lancé à chaque fois que le cadre sera redimensionné soit directement, soit comme résultant du redimensionnement de la fenêtre. +### Journaliser l'évolution de la taille de la fenêtre -### Exemple +#### HTML ```html - - - -exemple avec onresize - - - - - - +window.onresize = resize; ``` -### Notes +#### Résultat + +{{EmbedLiveSample("")}} + +## Spécifications + +{{Specifications}} + +## Compatibilité des navigateurs -Un attribut onresize peut être placé sur n'importe quel élément, mais seul l'objet `window` possède un évènement sur le redimensionnement. Le rédimensionnement d'autres éléments (par exemple, la modification de la largeur ou de la hauteur d'un élément img par un script) ne lancera aucun évènement de redimensionnement. +{{Compat}} -### Spécification +## Voir aussi -{{ DOM0() }} +- L'évènement [`resize`](/fr/docs/Web/API/Window/resize_event) From d700568cb45c7dceead0396c700c04b0036f6103 Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 15:13:47 +0200 Subject: [PATCH 16/27] update offsetparent vs en-US --- .../web/api/htmlelement/offsetparent/index.md | 31 ++++++++++--------- 1 file changed, 17 insertions(+), 14 deletions(-) diff --git a/files/fr/web/api/htmlelement/offsetparent/index.md b/files/fr/web/api/htmlelement/offsetparent/index.md index 71a075b8ac4453..5257c01623f2ca 100644 --- a/files/fr/web/api/htmlelement/offsetparent/index.md +++ b/files/fr/web/api/htmlelement/offsetparent/index.md @@ -1,26 +1,29 @@ --- -title: element.offsetParent +title: HTMLElement.offsetParent slug: Web/API/HTMLElement/offsetParent -tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko translation_of: Web/API/HTMLElement/offsetParent +browser-compat: api.HTMLElement.offsetParent --- -{{ ApiRef() }} +{{APIRef("HTML DOM")}} -### Résumé +La propriété en lecture seule **`HTMLElement.offsetParent`** fournit une référence vers le plus proche élément ancêtre positionné (plus proche selon la hiérarchie). S'il n'y a pas d'élément ancêtre positionné, c'est le plus proche ancêtre `td`, `th`, `table` qui sera renvoyé, ou `body` s'il n'y a non plus pas d'élément de tableau comme ancêtre. -Renvoie une référence à l'objet qui est l'élément conteneur positionné le plus proche (dans la hiérarchie de positionnement). Si l'élément n'est pas positionné, c'est l'élément racine (html en mode de respect des standards ; body en mode de rendu quirks) qui est l'**offsetParent**. +> **Note :** `offsetParent` renvoie `null` dans les situations suivantes : +> +> - La propriété `display` de l'élément ou de son élément parent vaut `none`. +> - La propriété `position` de l'élément vaut `fixed` (Firefox renverra ``). +> - L'élément courant est `` ou ``. -### Syntaxe +`offsetParent` est utile car [`offsetTop`](/fr/docs/Web/API/HTMLElement/offsetTop) et [`offsetLeft`](/fr/docs/Web/API/HTMLElement/offsetLeft) sont relatifs au bord de remplissage. - objetParent = element.offsetParent +## Valeur -### Paramètres +Une référence objet vers l'élément dans lequel l'élément courant est décalé. -- `objetParent` est une référence à l'élément dans lequel l'élément courant est positionné. +## Spécifications -### Spécification +{{Specifications}} -{{ DOM0() }} +## Compatibilité des navigateurs + +{{Compat}} From a66b6d9e82cc93a5468aa58ba16a322ad9da566a Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 15:20:54 +0200 Subject: [PATCH 17/27] update offsettop vs en-US --- .../fr/web/api/htmlelement/offsettop/index.md | 47 +++++++++---------- 1 file changed, 21 insertions(+), 26 deletions(-) diff --git a/files/fr/web/api/htmlelement/offsettop/index.md b/files/fr/web/api/htmlelement/offsettop/index.md index 68c4330e6fc01c..5d9f3be21a3647 100644 --- a/files/fr/web/api/htmlelement/offsettop/index.md +++ b/files/fr/web/api/htmlelement/offsettop/index.md @@ -1,42 +1,37 @@ --- -title: element.offsetTop +title: HTMLElement.offsetTop slug: Web/API/HTMLElement/offsetTop -tags: - - DOM - - DOM_0 translation_of: Web/API/HTMLElement/offsetTop +browser-compat: api.HTMLElement.offsetTop --- -{{ ApiRef() }} +{{APIRef("HTML DOM")}} -### Résumé +La propriété en lecture seule **`HTMLElement.offsetTop`** renvoie la distance entre la bordure extérieure de l'élément courant et la bordure intérieure haute de l'élément [`offsetParent`](/fr/docs/Web/API/HTMLElement/offsetParent) (le plus proche ancêtre positionné). -**offsetTop** renvoie la distance entre l'élément courant et le haut du nœud [`offsetParent`](/fr/docs/DOM/element.offsetParent). +## Valeur -### Syntaxe +Un nombre. - topPos = element.offsetTop; +## Exemples -### Paramètres +```js +let d = document.getElementById("div1"); +let topPos = d.offsetTop; -- `topPos` est le nombre de pixels depuis le haut de l'élément parent. +if (topPos > 10) { + // si le décalage est supérieur + // à 10 pixels par rapport au parent +} +``` -### Exemple +## Spécifications - d = document.getElementById("div1"); +{{Specifications}} - topPos = d.offsetTop; +## Compatibilité des navigateurs - if (topPos > 10 ) { +{{Compat}} - // l'objet est décalé de plus de - // 10 pixels par rapport à son parent +Pour respecter la spécification, cette propriété renverra `null` sur WebKit si l'élément est masqué (autrement dit si `style.display` vaut `none` pour cet élément ou l'un de ses ancêtres) ou si `style.position` vaut `"fixed"` pour l'élément courant. - } - -### Spécification - -{{ DOM0() }} - -### Références - -[_offsetTop definition_ sur MSDN](http://msdn2.microsoft.com/en-us/library/ms534303.aspx) +Cette propriété renverra `null` sur Internet Explorer (9) si `style.position` vaut `"fixed"` pour l'élément courant (`display:none` n'a pas d'impact pour ce navigateur). From 83cc119fcc6d75a4bb6c6b77f56a58cfc5bb5bb6 Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 15:28:04 +0200 Subject: [PATCH 18/27] update window.alert vs en-US --- files/fr/web/api/window/alert/index.md | 61 ++++++++++++++++---------- 1 file changed, 38 insertions(+), 23 deletions(-) diff --git a/files/fr/web/api/window/alert/index.md b/files/fr/web/api/window/alert/index.md index 9efdaf91089c48..38994371817add 100644 --- a/files/fr/web/api/window/alert/index.md +++ b/files/fr/web/api/window/alert/index.md @@ -1,45 +1,60 @@ --- -title: window.alert +title: Window.alert() slug: Web/API/Window/alert -tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko translation_of: Web/API/Window/alert +browser-compat: api.Window.alert --- -{{ ApiRef() }} +{{APIRef}} -### Résumé +`window.alert()` indique au navigateur d'afficher une boîte de dialogue avec un message optionnel, et d'attendre que la personne ferme cette boîte de dialogue. -Affiche un dialogue d'alerte contenant le texte spécifié. +Sous certaines conditions, par exemple au changement d'onglet, le navigateur pourra ne pas afficher la boîte de dialogue ou ne pas attendre que la personne la ferme. -### Syntaxe +## Syntaxe - window.alert(message); +```js +alert() +alert(message) +``` -- `message` est une chaîne contenant le texte à afficher dans le dialogue d'alerte. +### Paramètres -### Exemple +- `message` {{optional_inline}} + - : Une chaîne de caractères qu'on souhaite afficher dans la boîte de dialogue. Si la valeur fournie est un objet, elle sera convertie en chaîne de caractères puis affichée. - window.alert("Bonjour !"); +### Valeur de retour -produira : +Aucune ([`undefined`](/fr/docs/Web/JavaScript/Reference/Global_Objects/undefined)). + +## Exemples + +```js +window.alert("Hello world!"); +alert("Hello world!"); +``` + +produiront tous les deux ce qui suit : ![](alerthelloworld.png) -### Notes +## Notes + +Les boîtes de dialogue créées avec `alert()` ne doivent pas nécessiter de réponse de la part de l'utilisatrice ou de l'utilisateur, en dehors de l'acquittement du message. + +Ces boîtes de dialogue sont des fenêtres modales qui empêchent d'accéder au reste de l'interface utilisateur du programme, à moins que la boîte de dialogue soit fermée. Aussi, il ne faut pas abuser de cette fonction. -Le dialogue d'alerte doit être utilisé pour les messages qui ne demandent aucune réponse de la part de l'utilisateur, à part son acceptation du message. +Une autre méthode consiste à utiliser l'élément [``](/fr/docs/Web/HTML/Element/dialog) afin d'afficher des alertes. -Le texte suivant est commun à cet article, `DOM:window.prompt` et `DOM:window.confirm` Les boîtes de dialogue sont des fenêtres modales : elles empêchent l'utilisateur d'accéder au reste de l'interface du programme tant qu'elles ne sont pas fermées. C'est pourquoi il ne faut pas abuser des fonctions créant une boîte de dialogue (ou fenêtre modale). +## Spécifications -Les applications utilisant le chrome (par exemple les extensions) devront plutôt utiliser les méthodes de [nsIPromptService](fr/NsIPromptService). +{{Specifications}} -### Spécification +## Compatibilité des navigateurs -{{ DOM0() }} +{{Compat}} -### Voir aussi +## Voir aussi -- [confirm](/fr/DOM/window.confirm) -- [prompt](/fr/DOM/window.prompt) +- L'élément [``](/fr/docs/Web/HTML/Element/dialog) +- [`confirm`](/fr/docs/Web/API/Window/confirm) +- [`prompt`](/fr/docs/Web/API/Window/prompt) From 989dfa99be404cde25dcdba0f0732c0a5378f770 Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 15:38:00 +0200 Subject: [PATCH 19/27] update window.confirm vs en-US --- files/fr/web/api/window/confirm/index.md | 63 +++++++++++++++--------- 1 file changed, 41 insertions(+), 22 deletions(-) diff --git a/files/fr/web/api/window/confirm/index.md b/files/fr/web/api/window/confirm/index.md index 5a51a25ead39d4..8e9c0a34088f0f 100644 --- a/files/fr/web/api/window/confirm/index.md +++ b/files/fr/web/api/window/confirm/index.md @@ -1,41 +1,60 @@ --- -title: window.confirm +title: Window.confirm() slug: Web/API/Window/confirm -tags: - - DOM - - DOM_0 translation_of: Web/API/Window/confirm +browser-compat: api.Window.confirm --- {{ApiRef("Window")}} -### Résumé +`window.confirm()` indique au navigateur d'afficher une boîte de dialogue avec un message optionnel et d'attendre que la personne confirme ou annule la boîte de dialogue. -Affiche un dialogue modal avec un message et deux boutons, OK et Annuler. +Sous certaines conditions, par exemple au changement d'onglet, le navigateur pourra ne pas afficher la boîte de dialogue ou ne pas attendre la confirmation ou l'annulation. -### Syntaxe +## Syntaxe - resultat = window.confirm(message); +```js +confirm(message) +``` -- `message` est la chaîne contenant le texte à afficher dans le dialogue. -- `resultat` est une valeur booléenne indiquant si OK ou Annuler a été sélectionné (`true` signifie OK). +### Paramètres -### Exemple +- `message` + - : Une chaîne de caractères qu'on souhaite afficher dans la boîte de dialogue de confirmation. - if (window.confirm("Une nouvelle fenêtre va s'ouvrir.")) { - window.open("fenetre.html", "Nouvelle fenêtre", ""); - } +### Valeur de retour -### Notes +Un booléen qui indique si l'option « OK » (`true`) ou « Annuler » (`false`) a été sélectionnée. Si le navigateur ignore les boîtes de dialogue, la valeur renvoyée est toujours `false`. -Le texte suivant est commun à cet article, `DOM:window.prompt` et `DOM:window.confirm` Les boîtes de dialogue sont des fenêtres modales : elles empêchent l'utilisateur d'accéder au reste de l'interface du programme tant qu'elles ne sont pas fermées. C'est pourquoi il ne faut pas abuser des fonctions créant une boîte de dialogue (ou fenêtre modale). +## Exemples -Les applications utilisant le chrome (par exemple les extensions) devront plutôt utiliser les méthodes de [nsIPromptService](fr/NsIPromptService). +```js +if (window.confirm("Do you really want to leave?")) { + window.open("exit.html", "Thanks for Visiting!"); +} +``` -### Spécification +Créera le résultat suivant : -{{ DOM0() }} +![Confirmation dans Firefox](firefoxcomfirmdialog_zpsf00ec381.png) -### Voir aussi +## Notes -- [alert](/fr/docs/DOM/window.alert) -- [prompt](/fr/docs/DOM/window.prompt) +Ces boîtes de dialogue sont des fenêtres modales qui empêchent d'accéder au reste de l'interface utilisateur du programme, à moins que la boîte de dialogue soit fermée. Aussi, il ne faut pas abuser de cette fonction. + +Il y a également d'autres raisons [d'éviter les boîtes de dialogue pour demander une confirmation](https://alistapart.com/article/neveruseawarning/). + +Une autre méthode consiste à utiliser l'élément [``](/fr/docs/Web/HTML/Element/dialog) afin d'afficher des demandes de confirmation. + +## Spécifications + +{{Specifications}} + +## Compatibilité des navigateurs + +{{Compat}} + +## Voir aussi + +- L'élément [``](/fr/docs/Web/HTML/Element/dialog) +- [`window.alert()`](/fr/docs/Web/API/Window/alert) +- [`window.prompt()`](/fr/docs/Web/API/Window/prompt) From 02024b8440876a769dffd3a779884c34f5797452 Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 15:44:54 +0200 Subject: [PATCH 20/27] update window.dump vs en-US --- files/fr/web/api/window/dump/index.md | 36 +++++++++++++-------------- 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/files/fr/web/api/window/dump/index.md b/files/fr/web/api/window/dump/index.md index 6eb59b8b00b7dd..419aecd5e18b91 100644 --- a/files/fr/web/api/window/dump/index.md +++ b/files/fr/web/api/window/dump/index.md @@ -1,34 +1,34 @@ --- -title: window.dump +title: Window.dump() slug: Web/API/Window/dump -tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko translation_of: Web/API/Window/dump +browser-compat: api.Window.dump --- -{{ ApiRef() }} +{{ApiRef}} {{Non-standard_header}} -### Résumé +La méthode **`Window.dump()`** permet d'afficher des messages sur la sortie standard (`stdout`) du navigateur. Si le navigateur a été démarré depuis un terminal, la sortie produite par `dump()` apparaîtra dans le terminal. -Affiche des messages dans la console (native). +La sortie produite par `dump()` n'est _pas_ envoyée vers la console des outils de développement du navigateur. Pour afficher des messages dans la console des outils de développement, il faudra utiliser [`console.log()`](/fr/docs/Web/API/Console/log). -### Syntaxe +## Syntaxe - dump(message); +```js +dump(message) +``` -- `message` est le message texte à afficher. +### Paramètres -### Notes +- `message` + - : Une chaîne de caractères contenant le message à afficher. -`dump` est habituellement utilisé pour débogage du JavaScript. Du code avec permissions peut également utiliser [Components.utils.reportError](/fr/Components.utils.reportError) et [nsIConsoleService](/fr/nsIConsoleService) pour afficher des messages dans la [console JavaScript](/fr/Console_JavaScript). +### Valeur de retour -Dans [Gecko](/fr/Gecko), `dump` est désactivé par défaut – il ne fait rien mais ne génère aucune erreur. Pour que `dump` écrive dans le flux standard de sortie, vous devez l'activer en mettant la préférence `browser.dom.window.dump.enabled` à `true`. Vous pouvez définir cette préférence dans [about:config](http://kb.mozillazine.org/About:config) ou dans un [fichier user.js](http://kb.mozillazine.org/User.js_file). +Aucune ([`undefined`](/fr/docs/Web/JavaScript/Reference/Global_Objects/undefined)). -Vous aurez besoin d'une console pour voir quelque chose. Si vous n'en avez pas déjà une, fermez et réouvrez le programme en ajoutant le paramètre `-console` à la ligne de commande. +## Spécifications -`dump` est également disponible au composants XPCOM implémentés en JavaScript, même si [window](/fr/DOM/window) n'est pas l'objet global dans ce contexte. +Cette fonctionnalité ne fait partie d'aucune spécification. -### Spécification +## Compatibilité des navigateurs -{{ DOM0() }} +{{Compat}} From 5eec8303dda02a8605fd3bea5ff30bf4a7099bc8 Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 15:50:21 +0200 Subject: [PATCH 21/27] update window.fullscreen vs en-US --- files/fr/web/api/window/fullscreen/index.md | 46 +++++++++------------ 1 file changed, 20 insertions(+), 26 deletions(-) diff --git a/files/fr/web/api/window/fullscreen/index.md b/files/fr/web/api/window/fullscreen/index.md index 549e41ee632f17..aaa97e77de9b7e 100644 --- a/files/fr/web/api/window/fullscreen/index.md +++ b/files/fr/web/api/window/fullscreen/index.md @@ -1,40 +1,34 @@ --- -title: window.fullScreen +title: Window.fullScreen slug: Web/API/Window/fullScreen -tags: - - DOM - - DOM_0 - - Référence_du_DOM_Gecko translation_of: Web/API/Window/fullScreen +browser-compat: api.Window.fullScreen --- -{{ ApiRef() }} +{{APIRef}}{{Non-standard_Header}} -### Résumé +La propriété **`fullScreen`**, rattachée à l'interface `Window`, indique si la fenêtre est affichée en mode plein écran ou non. -Cette propriété indique si la fenêtre est affichée en mode plein écran ou non. Elle n'est fiable qu'à partir de Gecko 1.9 (Firefox 3), voir les Notes plus bas. +Avec des privilèges sur le chrome, cette propriété est accessible en lecture-écriture, sinon elle est uniquement accessible en lecture. Il faut garder à l'esprit que tenter de modifier cette propriété sans disposer des privilèges sur le chrome ne déclenchera pas d'exception mais échouera silencieusement. Ce comportement évite de casser les scripts qui modifient cette propriété pour Internet Explorer. -### Syntaxe +## Valeur - var isInFullScreen = windowRef.fullScreen; +Une valeur booléenne qui indique si la fenêtre est en plein écran. -Avec les privilèges chrome, la propriété est modifiable ; autrement elle est en lecture seule. Souvenez-vous que si vous essayez de définir cette propriété sans les privilèges chrome, aucune exception ne sera déclenchée et l'appel échouera juste silencieusement. Cela permet d'empêcher que des scripts conçus pour utiliser cette propriété dans Internet Explorer cessent de fonctionner. +## Notes -### Valeur de retour +- Passer entre le mode normal et le mode plein écran déclenchera l'évènement `resize` sur la fenêtre correspondante. -- `isInFullScreen` - - : Une valeur booléenne. Signification des valeurs : +## Exemples - +```js +if (window.fullScreen) { + // en plein écran ! +} +else { + // pas en plein écran ! +} +``` -- `true` : La fenêtre est en mode plein écran. -- `false` : La fenêtre n'est pas en mode plein écran. +## Compatibilité des navigateurs -### Exemples - -### Spécification - -{{ DOM0() }} - -### Notes - -Cette propriété n'est fiable qu'à partir de Mozilla 1.9 (Firefox 3). Mozilla 1.8 et les versions antérieures disposent de cette propriété, mais elle renvoie toujours `false`, même quand la fenêtre est en mode plein écran ({{ Bug(127013) }}). +{{Compat}} From 7effc4b53f3c6304a41c7624fca62ac77fed3de8 Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 15 May 2022 15:52:48 +0200 Subject: [PATCH 22/27] update window.length vs en-US --- files/fr/web/api/window/length/index.md | 23 +++++++++++++---------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/files/fr/web/api/window/length/index.md b/files/fr/web/api/window/length/index.md index c9efe7f9c031f3..651265177fdc9b 100644 --- a/files/fr/web/api/window/length/index.md +++ b/files/fr/web/api/window/length/index.md @@ -2,25 +2,28 @@ title: Window.length slug: Web/API/Window/length translation_of: Web/API/Window/length +browser-compat: api.Window.length --- -{{ ApiRef() }} +{{ApiRef}} -Retourne le nombre de frames (soit des éléments de frame ou iframe) présent sur la page. +Renvoie le nombre de frames (que ce soit des éléments [``](/fr/docs/Web/HTML/Element/frame) ou [`