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 -
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 +Voir une bulle d'information 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 +