Un conteneur utilisé pour afficher le contenu d'un menu popup. Lorsqu'un menupopup est ouvert, il flotte par dessus la fenêtre et peut s'étendre en dehors de celle-ci. Les menupopups peuvent être utilisés de plusieurs manières :
- On peut les placer dans un élément
menu
,menulist
oubutton
avec l'attribut type défini à « menu » pour créer un popup qui s'ouvrira lors d'un clic sur le bouton ou menu. - On peut les attacher à n'importe quel élément à l'aide de l'attribut
popup
. Lors d'un clic gauche sur l'élément, le menupopup sera affiché. - On peut les attacher à n'importe quel élément à l'aide de l'attribut
context
. Lors de l'ouverture d'un menu contextuel, le menupopup sera affiché. Un menu contextuel peut être ouvert par un clic droit sur l'élément ou l'appui sur la touche menu du clavier.
Vous trouverez plus d'informations dans le Tutoriel XUL.
- Attributs
- ignorekeys, left, onpopuphidden, onpopuphiding, onpopupshowing, onpopupshown, position, top
- Propriétés
- accessibleType, popupBoxObject, popup, state
Exemples
L'exemple suivant montre l'attachement d'un menupopup à un élément menulist
.
<menulist> <menupopup> <menuitem label="Mozilla" value="http://mozilla.org"/> <menuitem label="Slashdot" value="http://slashdot.org"/> <menuitem label="Sourceforge" value="http://sf.net"/> <menuitem label="Freshmeat" value="http://freshmeat.net"/> </menupopup> </menulist>
L'exemple qui suit montre l'utilisation d'un menupopup comme menu contextuel d'un élément. Lors d'un clic droit sur le label, le menu sera affiché.
<menupopup id="clipmenu"> <menuitem label="Couper"/> <menuitem label="Copier"/> <menuitem label="Coller"/> </menupopup> <label value="Clic droit pour ouvrir un popup" context="clipmenu"/>
Attributs
-
onpopuphiding
- Type : code de script
- Cet évènement est envoyé à un popup lorsqu'il est sur le point d'être masqué.
-
onpopupshowing
- Type : code de script
- Cet évènement est envoyé à un popup juste avant son ouverture. On l'utilise généralement pour définir dynamiquement le contenu lorsque l'utilisateur demande son affichage. Si ce gestionnaire d'évènement renvoie
false
, le popup ne s'affichera pas.
-
onpopupshown
- Type : code de script
- Cet évènement est envoyé à un popup après son ouverture, de la même manière qu'un évènement
onload
est envoyé à une fenêtre à son ouverture.
- position
- Type : une des valeurs ci-dessous
- L'attribut
position
détermine où le popup apparaît par rapport à l'élément sur lequel l'utilisateur a cliqué pour l'invoquer. C'est ce qui permet de placer le popup sur le bord d'un bouton.
-
after_start
: Le popup apparait en dessous l'élément avec le coin supérieur gauche du popup aligné avec le coin inférieur gauche de l'élément. Les bords gauches de l'élément et du popup sont sur la même ligne. Cette valeur est typiquement uilisée pour les menus déroulants. -
after_end
: Le popup apparait en dessous l'élément avec le coin supérieur droit du popup aligné avec le coin inférieur droit de l'élément. Les bords droits de l'élément et du popup sont sur la même ligne. -
before_start
: Le popup apparait au dessus de l'élément avec le coin inférieur gauche du popup aligné avec le coin supérieur gauche de l'élément. Les bords gauches de l'élément et du popup sont sur la même ligne. -
before_end
: Le popup apparait au dessus de l'élément avec le coin inférieur droit du popup aligné avec le coin supérieur droit de l'élément. Les bords droits de l'élément et du popup sont sur la même ligne. -
end_after
: Le popup apparait à la droite de l'élément avec le coin inférieur gauche du popup aligné avec le coin inférieur droit de l'élément. Les bords inférieurs de l'élément et du popup sont sur la même ligne. -
end_before
: Le popup apparait à la droite de l'élément avec le coin supérieur gauche du popup aligné avec le coin supérieur droit de l'élément. Les bords supérieurs de l'élément et du popup sont sur la même ligne. -
start_after
: Le popup apparait à la gauche de l'élément avec le coin inférieur droit du popup aligné avec le coin inférieur gauche de l'élément. Les bords inférieurs de l'élément et du popup sont sur la même ligne. -
start_before
: Le popup apparait à la gauche de l'élément avec le coin supérieur droit du popup aligné avec le coin supérieur gauche de l'élément. Les bords supérieurs de l'élément et du popup sont sur la même ligne. -
overlap
: Le popup apparait par dessus l'élément avec les coins supérieurs gauches alignés. -
at_pointer
: Le popup apparait à la position du pointeur de la souris. -
after_pointer
: Le popup apparait à la même position horizontale que le pointeur de la souris, mais verticalement, il est placé juste sous l'élément.
Propriétés
Méthodes
Sujets liés
- Éléments
-
menu
,menubar
,menuitem
,menulist
,menuseparator
- Interfaces
- nsIAccessibleProvider, nsIDOMXULPopupElement