Attention : Le contenu de ces pages n'a pas été mis à jour depuis longtemps. Il est probablement obsolète pour Firefox 4.0/Gecko 4.0 et supérieur. Pour du contenu plus récent, allez consulter developer.mozilla.org.

Attributs evenements

Voici la liste des attributs pour capturer les évenements arrivant sur la plupart des élements XUL

Liste des attributs

ToDo : descriptions à compléter et liste des éléments sur lesquel les attributs peuvent fonctionner

onblur

Evénement associé => blur
L'événement blur est activé lorsque l'élément perd le focus.

Note : l'attribut onblur associé à l'événement blur est l'opposé de l'attribut onfocus associé à l'événement focus.

L'attribut onblur fonctionne sur les éléments :

  1. textbox
  2. listbox
  3. ...

onbroadcast

Evénement associé => broadcast
L'événement broadcast est activé lorsqu'un attribut d'un élément observé est modifié.

L'attribut onbroadcast fonctionne uniquement sur les éléments observés.

onchange

Evénement associé => change
L'événement change est activé lorsque la valeur de l'élément est modifié.

Note : l'événement est activé seulement lors de la perte du focus par l'élément.

L'attribut onchange fonctionne sur les éléments :

  1. textbox
  2. ...

onclick

Evénement associé => click : L'événement click est activé lors d'un clic[1] d'un bouton de la souris. Cet événement est aussi activé lors d'un double-clic[2], triple-clic(( clic-gauche
le bouton gauche de la souris est appuyé puis relaché))... (le nombre de clics est indiqué dans les propriétés de l'événement).

Note : le bouton cliqué (gauche, droit...) est indiqué dans les propriétés de l'événement.

Note 2 : pour réaliser une action lors de l'activation de l'élément, il est préférable d'utiliser l'attribut oncommand associé à l'événement command qui ne sera pas restreint à l'activation par la souris.

L'attribut onclick fonctionne sur tout les éléments (à vérifier)

onclose

Evénement associé => close
L'événement close est activé uniquement lors de l'appui sur le bouton de fermeture de la fenêtre dans la barre de titre (la croix).

Note : si le fenêtre est observée, l'événement close sera bloqué.

Note 2 : la fenêtre sera fermée uniquement si l'action effectuée retourne la valeur true.

Note 3 : pour intercepter toutes les demandes de fermeture de la fenêtre (et non pas uniquement lors de l'appui sur le bouton de fermeture de la fenêtre), il faut utiliser l'attribut onunload associé à l'événement unload

L'attribut onclose fonctionne sur l'élément :

  1. window

oncommand

Evénement associé => command
L'événement command est activé lorsque l'élément est activé.

Note : les éléments peuvent être activés de différentes manières (exemple: un bouton peut être activé en cliquant[3] dessus avec la souris ou en appuyant sur ENTER lorsque le bouton à le focus, un menu peut être activé en le sélectionnant avec la souris ou en appuyant sur un raccourci clavier,...).

L'attribut oncommand fonctionne sur tout les éléments activables :

  1. button
  2. menu
  3. ...

oncommandupdate

Evénement associé => commandupdate
L'événement commandupdate est activé lors de la mise à jour d'une commande d'un élément <commandset>.

L'attribut oncommandupdate fonctionne sur l'élément :

  1. commandset

oncontextmenu

Evénement associé => contextmenu : L'événement contextmenu est activé lors de la demande de l'ouverture du menu contextuel (en général un clic-droit(( clic-droit
le bouton droit de la souris est appuyé puis relaché))).

Note : l'attribut oncontextmenu associé à l'événement contextmenu est souvent utilisé pour rendre dynamique le menu contextuel.

Note 2 : le menu contextuel sera ouvert uniquement si l'action effectuée retourne la valeur true.

Note 3 : l'attribut onpopupshowing associé à l'événement popupshowing peut être utilisé à la place.

L'attribut oncontextmenu fonctionne sur tout les éléments (à vérifier)

ondblclick

Evénement associé => dblclick : L'événement dblclick est activé lors d'un double-clic(( double-clic, triple-clic
le bouton est appuyé puis relaché deux fois ou trois fois de suite)) d'un bouton de la souris.

Note : c'est une alternative à l'attribut onclick associé à l'événement click pour détecter le double-clic[4].

L'attribut ondblclick fonctionne sur tout les éléments (à vérifier)

ondragdrop

Evénement associé => dragdrop : L'événement dragdrop est activé lors du drop(( drop
le bouton de la souris est relaché à la fin du drag&drop afin de déposer l'objet (syn. dépôt))) d'un objet.

Note : l'élément, si il accepte le drag&drop[6]), doit insérer l'objet.

L'attribut ondragdrop fonctionne sur les éléments :

  1. ...

ondragenter

Evénement associé => dragenter : L'événement dragenter est activé lorsque la souris arrive au-dessus de l'élément pendant le drag(( drag
l'objet est déplacé durant le drag&drop (syn. déplacement))).

Note : cet attribut est similaire à l'attribut onmouseover associé à l'événement mouseover mais il est activé uniquement lors des drag&drop[8])

L'attribut ondragenter fonctionne sur les éléments :

  1. ...

ondragexit

Evénement associé => dragexit : L'événement dragexit est activé lorsque la souris n'est plus au-dessus de l'élément pendant le drag[9]) d'un objet. Cet événement est aussi activé lors du drop(( drop
le bouton de la souris est relaché à la fin du drag&drop afin de déposer l'objet (syn. dépôt))) de l'objet.

Note : cet attribut est similaire à l'attribut onmouseout associé à l'événement mouseout mais il est activé uniquement lors des drag&drop[11])

L'attribut ondragexit fonctionne sur les éléments :

  1. ...

ondraggesture

Evénement associé => draggesture : L'événement draggesture est activé lors du commencement du drag&drop(( drag&drop : le drag&drop est le fait de sélectionner un objet avec la souris (le bouton de la souris est appuyé), puis de le déplacer {drag(( drag
l'objet est déplacé durant le drag&drop (syn. déplacement)))} (en gardant le bouton de la souris appuyé) et enfin de le déposer {drop!PWNOTE7!} (le bouton de la souris est relaché))), en général après la sélection en appuyant sur la souris puis en déplaçant la souris tout en restant appuyé.

L'attribut ondraggesture fonctionne sur les éléments :

  1. ...

ondragover

Evénement associé => dragover : L'événement dragover est activé lors du drag(( drag
l'objet est déplacé durant le drag&drop (syn. déplacement))) d'un objet au-dessus de l'élément.

Note : l'événement doit indiquer si il peut y avoir le drop[12]) de l'objet.

Note 2 : cet attribut est similaire à l'attribut onmousemove associé à l'événement mousemove mais il est activé uniquement lors des drag&drop[14])

L'attribut ondragover fonctionne sur les éléments :

  1. ...

onfocus

Evénement associé => focus
L'événement focus est activé lorsque l'élément recoit le focus.

Note : l'attribut onfocus associé à l'événement focus est l'opposé de l'attribut onblur associé à l'événement blur.

L'attribut onfocus fonctionne sur les éléments :

  1. textbox
  2. listbox
  3. ...

oninput

Evénement associé => input
L'événement input est activé lorsqu'un texte est entré dans une textbox.

Note : l'événement est envoyé seulement lorsque le texte affiché est modifié, l'ajout d'un caractère non imprimable n'active pas l'événement.

L'attribut oninput fonctionne sur l'élément :

  1. textbox

onkeydown

Evénement associé => keydown
L'événement keydown est activé lorsqu'une touche est appuyée (mais pas relachée).

L'attribut onkeydown fonctionne sur les éléments :

  1. textbox
  2. ...

onkeypress

Evénement associé => keypress
L'événement keypress est activé lorsqu'une touche est appuyée puis relachée.

Note : lors de l'appui d'une touche, l'événement keydown est activé en premier, suivit par l'événement keypress et enfin par l'événement keyup.

L'attribut onkeypress fonctionne sur les éléments :

  1. textbox
  2. ...

onkeyup

Evénement associé => keyup
L'événement keyup est activé lorsqu'une touche est relachée.

L'attribut onkeyup fonctionne sur les éléments :

  1. textbox
  2. ...

onload

Evénement associé => load
L'événement load est activé lorsque l'élément (fenêtre, image...) est chargé en totalité.

L'attribut onload fonctionne sur les éléments :

  1. window
  2. ...

onmousedown

Evénement associé => mousedown
L'événement mousedown est activé lorsqu'un bouton de la souris est appuyé (mais pas relaché) sur l'élément.

L'attribut onmousedown fonctionne sur tout les éléments (à vérifier)

onmousemove

Evénement associé => mousemove
L'événement mousemove est activé de façon répétitive tant que la souris est déplacé au-dessus de l'élément.

L'attribut onmousemove fonctionne sur tout les éléments (à vérifier)

onmouseout

Evénement associé => mouseout
L'événement mouseout est activé de lorsque la souris n'est plus au-dessus de l'élément.

Note : l'attribut onmouseout associé à l'événement mouseout est l'opposé de l'attribut onmouseover associé à l'événement mouseover.

L'attribut onmouseout fonctionne sur tout les éléments (à vérifier)

onmouseover

Evénement associé => mouseover
L'événement mouseover est activé de lorsque la souris arrive au-dessus de l'élément.

Note : l'attribut onmouseover associé à l'événement mouseover est l'opposé de l'attribut onmouseout associé à l'événement mouseout.

L'attribut onmouseover fonctionne sur tout les éléments (à vérifier)

onmouseup

Evénement associé => mouseup
L'événement mouseup est activé lorsqu'un bouton de la souris est relaché sur l'élément.

L'attribut onmouseup fonctionne sur tout les éléments (à vérifier)

onoverflow

Evénement associé => overflow
L'événement overflow est activé uniquement lorsque la propriété overflow de l'élément est mise à une valeur différente de 'visible'.

Note : si il n'y a pas assez de place pour afficher le contenu complet de l'élément, l'événement overflow est activé.

Note 2 : en fonction de la valeur de la propriété overflow de l'élément des scrollbars peuvent apparaître.

L'attribut onoverflow fonctionne sur tout les éléments boîtes (à vérifier) :

  1. box
  2. hbox
  3. vbox
  4. ...

onoverflowchanged

onpopuphidden

Evénement associé => popuphidden
L'événement popuphidden est activé après que la popup soit cachée.

L'attribut onpopuphidden fonctionne sur les éléments :

  1. popup
  2. ...

onpopuphiding

Evénement associé => popuphiding
L'événement popuphiding est activé avant que la popup soit cachée.

L'attribut onpopuphiding fonctionne sur les éléments :

  1. popup
  2. ...

onpopupshowing

Evénement associé => popupshowing
L'événement popupshowing est activé avant que la popup soit affichée.

Note : la popup sera ouvert uniquement si l'action effectuée retourne la valeur true.

Note 2 : l'attribut onpopupshowing associé à l'événement popupshowing est souvent utilisé pour rendre dynamique le contenu de la popup à afficher.

L'attribut onpopupshowing fonctionne sur les éléments :

  1. popup
  2. ...

onpopupshown

Evénement associé => popupshown
L'événement popupshown est activé après que la popup soit affichée.

L'attribut onpopupshown fonctionne sur les éléments :

  1. popup
  2. ...

onselect

Evénement associé => select
L'événement select est activé lorsqu'un élément de la liste ou de l'arbre a été sélectionné.

L'attribut onselect fonctionne sur les éléments :

  1. listbox
  2. tree
  3. ...

onunderflow

Evénement associé => underflow
L'événement underflow est activé lorsqu'un élément, ayant une propriété CSS overflow différente de 'visible', a assez d'espace disponible pour s'afficher de façon complète.

Note : l'attribut onunderflow associé à l'événement underflow peut être utilisé pour indiquer au mécanisme de défilement qu'il n'y a pas besoin de plus de place.

L'attribut onoverflow fonctionne sur tout les éléments boîtes (à vérifier) :

  1. box
  2. hbox
  3. vbox
  4. ...

onunload

Evénement associé => unload
L'événement unload est activé lorsque la fenêtre est fermée.

Note : l'événement unload est activé après l'événement close.

L'attribut onunload fonctionne sur les éléments :

  1. window
  2. ...

Liens externes

  1. Voir le mozilla developer center (en)

Notes

[1] clic : le bouton est appuyé puis relaché

[2] double-clic, triple-clic : le bouton est appuyé puis relaché deux fois ou trois fois de suite

[3] clic : le bouton est appuyé puis relaché

[4] double-clic, triple-clic : le bouton est appuyé puis relaché deux fois ou trois fois de suite

[5] drag : l'objet est déplacé durant le drag&drop (syn. déplacement

[6] drag&drop : le drag&drop est le fait de sélectionner un objet avec la souris (le bouton de la souris est appuyé), puis de le déplacer {drag[5])} (en gardant le bouton de la souris appuyé) et enfin de le déposer {drop!PWNOTE7!} (le bouton de la souris est relaché

[7] drag : l'objet est déplacé durant le drag&drop (syn. déplacement

[8] drag&drop : le drag&drop est le fait de sélectionner un objet avec la souris (le bouton de la souris est appuyé), puis de le déplacer {drag[7])} (en gardant le bouton de la souris appuyé) et enfin de le déposer {drop!PWNOTE7!} (le bouton de la souris est relaché

[9] drag : l'objet est déplacé durant le drag&drop (syn. déplacement

[10] drag : l'objet est déplacé durant le drag&drop (syn. déplacement

[11] drag&drop : le drag&drop est le fait de sélectionner un objet avec la souris (le bouton de la souris est appuyé), puis de le déplacer {drag[10])} (en gardant le bouton de la souris appuyé) et enfin de le déposer {drop!PWNOTE7!} (le bouton de la souris est relaché

[12] drop : le bouton de la souris est relaché à la fin du drag&drop afin de déposer l'objet (syn. dépôt

[13] drag : l'objet est déplacé durant le drag&drop (syn. déplacement

[14] drag&drop : le drag&drop est le fait de sélectionner un objet avec la souris (le bouton de la souris est appuyé), puis de le déplacer {drag[13])} (en gardant le bouton de la souris appuyé) et enfin de le déposer {drop!PWNOTE7!} (le bouton de la souris est relaché


Copyright © 2003-2013 association xulfr, 2013-2016 Laurent Jouanneau - Informations légales.

Mozilla® est une marque déposée de la fondation Mozilla.
Mozilla.org™, Firefox™, Thunderbird™, Mozilla Suite™ et XUL™ sont des marques de la fondation Mozilla.