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) diff --git a/files/fr/web/api/globaleventhandlers/onblur/index.md b/files/fr/web/api/globaleventhandlers/onblur/index.md index 286ccc3d95d0eb..15f6dfab96f185 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 +cible.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 sein 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) diff --git a/files/fr/web/api/globaleventhandlers/onchange/index.md b/files/fr/web/api/globaleventhandlers/onchange/index.md index 669a38b5d66326..33b104964a1d9d 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 +cible.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) diff --git a/files/fr/web/api/globaleventhandlers/ondblclick/index.md b/files/fr/web/api/globaleventhandlers/ondblclick/index.md index a4ecb0a523f6ed..7f532eb9174d13 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 +cible.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) 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) 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) 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) diff --git a/files/fr/web/api/globaleventhandlers/onmousedown/index.md b/files/fr/web/api/globaleventhandlers/onmousedown/index.md index 77e14f71e0801d..8b48e177bc1e2e 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. +### 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 + +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) 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) 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}} 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) 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) 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}} 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). 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) 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) 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}} 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}} 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 [`