menupopup

« Accueil de la référence XUL [ Exemples | Attributs | Propriétés | Méthodes | Sujets liés ]

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 ou button 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

Méthodes: hidePopup, moveTo, openPopup, openPopupAtScreen, showPopup, sizeTo

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

onpopuphidden: Type : code de script; Cet évènement est envoyé à un popup après qu'il a été caché. http://www.langue-fr.net/index/A/apres-que.htm

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.