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.

Menupopup

BalisesDescriptifIncomplet (voir plus bas)

Un élément utilisé pour afficher un menu. Cela doit être placé dans un élément menu, menulist ou menubutton. Un menupopup peut contenir n'importe quel élément, mais il contient habituellement des menuitems. C'est une sorte de box qui est orienté verticalement par défaut.

Attributs de la balise

Herités de Reference/Xul/ElementXul

oncontextmenu

Cet évènement est envoyé à un élément quand l'utilisateur demande d'ouvrir le menu contextuel de l'élément. L'action qui le permet varie selon les plateformes, mais ce sera en général un clic droit.

(Ce gestionnaire est habituellement utilisé pour attribuer dynamiquement des commandes au menu quand l'utilisateur l'ouvre, mais vous pouvez utiliser aussi l'évènement onpopupshowing. Renvoyer "false" (faux) de ce gestionnaire d'évènement empêche la popup d'apparaître. - Cette partie me paraît incorrecte, ou alors j'ai mal compris... - VincentSchirmann)

onpopuphidden

Cet évènement est envoyé à la popup après qu'elle ait été cachée. This event is sent to a popup after it has been hidden.

onpopupshowing

Cet évènement est envoyé à la popup juste avant qu'elle ne s'affiche. Ce gestionnaire est habituellement utilisé pour attribuer dynamiquement des commandes au menu quand l'utilisateur l'ouvre. Renvoyer "false" (faux) de ce gestionnaire d'évènement empêche la popup d'apparaître.

onpopupshown

Cet évènement est envoyé à la popup juste après qu'elle ne se soit affichée, tout comme l'évènement onload est envoyé à une fenêtre après son ouverture.

position

L'attribut position determine où apparaît la popup par rapport à l'élément que l'utilisateur à cliqué pour ouvrir la popup. Cela vous permet de placer le menu à un côté du bouton.

;after_start: La popup apparaît sous l'élément avec le coin supérieur gauche de la popup aligné avec le coin inférieur gauche de l'élément. les bords gauches de l'élément et de la popup sont alignés. C'est habituellement utilisé pour les menus déroulants. ;after_end: La popup apparaît sous l'élément avec le coin supérieur droit de la popup aligné avec le coin inférieur droit de l'élément. les bords droits de l'élément et de la popup sont alignés. ;before_start: La popup apparaît au-dessus de l'élément avec le coin inférieur gauche de la popup aligné avec le coin supérieur gauche de l'élément. les bords gauches de l'élément et de la popup sont alignés. ;before_end: La popup apparaît au-dessus de l'élément avec le coin inférieur droit de la popup aligné avec le coin supérieur droit de l'élément. les bords droits de l'élément et de la popup sont alignés. ;end_after: La popup apparaît à droite de l'élément avec le coin inférieur gauche de la popup aligné avec le coin inférieur droit de l'élément. les bords du bas de l'élément et de la popup sont alignés. ;end_before: La popup apparaît à droite de l'élément avec le coin supérieur gauche de la popup aligné avec le coin supérieur droit de l'élément. les bords du haut de l'élément et de la popup sont alignés. ;start_after: La popup apparaît à gauche de l'élément avec le coin inférieur droit de la popup aligné avec le coin inférieur gauche de l'élément. les bords du bas de l'élément et de la popup sont alignés. ;start_before: La popup apparaît à gauche de l'élément avec le coin supérieur droit de la popup aligné avec le coin supérieur gauche de l'élément. les bords du haut de l'élément et de la popup sont alignés. ;overlap: La popup apparaît par dessus l'élément avec les coins supérieurs gauches alignés. ;at_pointer: La popup apparaît au même endroit que le pointeur de souris. ;after_pointer: La popup apparaît sur la même ligne horizontale que le pointeur de souris, mais verticallement, elle est placé juste sous l'élément.

Propriétés Javascript

Heritées de Reference/Xul/ElementXul

autoPosition Moz0.9.5

popupBoxObject Moz0.9.5

Cet propriété en lecture seule contient le nsIPopupBoxObject qui implemente la popup. Vous ne devriez pas avoir à vous servir de cette propriété, car toutes ces fonctions sont utilisables via la popup en elle-même.

position

Méthodes Javascript

Heritées de Reference/Xul/ElementXul

enableKeyboardNavigator ( enable ) Moz0.9.5

Permet ou empêche la navigation par le clavier sur le menupopup.

enableRollup ( enable ) Moz0.9.5

hidePopup ( )

Ferme la popup immediatement.

moveTo ( x , y ) Moz0.9.5

Déplace la popup à un autre endroit (spécifié par les coordonnées x et y).

showPopup ( element, x , y , popupType, anchor, align )

Ouvre le menu popup à la position (x,y) relative à l'élément. "popupType" peut être les chaînes de caractères "popup", "context" ou "tooltip".Les paramètres "anchor" et "align" correspondent respectivement aux attributs "popupanchor" et "popupalign" de l'élément.

sizeTo ( width , height ) Moz0.9.5

Change la taille courante de la popup ("width"=largeur, "height"=hauteur)

Balises filles

Références


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.