Reference/Xul/menulist

Un élément menulist correspond à un menu déroulant.

BalisesDescriptifIncomplet Aidez nous à compléter cette page !

 <menulist>
     <menupopup>
         <menuitem label="Aubergine"/>
         <menuitem label="Choux"/>
         <menuitem label="Carotte"/>
         <menuitem label="Tomate"/>
     </menupopup>
 </menulist>

Attributs de la balise

Herités de ElementXul, plus :

accesskey

deprecié. Utiliser de préférence un élément label ayant les attributs control et accesskey renseignés.

Caractère qui définit le raccourci clavier permettant d'accéder directement à cet élément menulist. Typiquement, cet attribut est une lettre contenue dans l'élément label associé. Selon la plateforme et le thème utilisés, cette lettre sera mise en valeur pour signifier à l'utilisateur qu'il peut accéder directement à la liste déroulante en utilisant le raccourci correspondant.

Ex: sous windows les raccourcis clavier s'utilisent en combinant la touche 'Alt' et la lettre de raccourci.

crop

Indique de quelle manière le libellé affiché doit être tronqué si l'espace dont il dispose n'est pas suffisant. Un marqueur (des points de suspension) indique alors quelle partie du texte a été tronquée.

start

Le libellé sera tronqué à gauche

end

Le libellé sera tronqué à droite

center

Le libellé sera tronqué des deux côtés

none

Le libellé sera tronqué mais aucun marqueur ne sera présent pour l'indiquer. D'autre part, le côté tronqué dépendra de l'attribut CSS text-alignment.

disableautoselect

disabled

editable

focused

image

label

deprecié semble-t-il sous firefox 1.0.3
Définit le libellé par défaut de la liste lors du premier affichage de l'élément, indépendamment de ce qu'elle contient.

open

src

tabindex

value

Propriétés Javascript

Heritées de ElementXul, plus :

accessible

crop

disabled

inputfield

label

menuBoxObject

menupopup

open

select

selectedIndex

selectedItem

src

value

Méthodes Javascript

Heritées de ElementXul, plus :

appendItem

disableautoselect

insertItemAt

removeAllItems

removeItemAt

Balises filles

• menupopup

Astuces, Notes, bogues

Les attributs label et accesskey semblent ne plus jouer le rôle indiqué dans la référence xulplanet.

• Pour obtenir le comportement escompté de l'attribut accesskey il faut créer un élément label comportant l'attribut accesskey et ayant l'attribut control pointant sur l'id de l'élément menulist.
  Exemple : pour que le focus soit placer sur notre liste de légumes en tapant 'Alt' + 'l'

 <label control="cmbVegetable" value="Légume préféré" accesskey="l"/>
 <menulist id="cmbVegetable">
     <menupopup>
         <menuitem label="Aubergine"/>
         <menuitem label="Choux"/>
         <menuitem label="Carotte"/>
         <menuitem label="Tomate"/>
     </menupopup>
 </menulist>

• Pour obtenir le comportement escompté de l'attribut label qui est définir le choix par défaut dans la liste, il s'agit en fait de placer à true l'attribut selected de l'élément menuitem voulu.
  Exemple : pour le choix par défaut de notre liste de légumes soit "Carotte" au lieu de "Aubergine"

 <menulist>
     <menupopup>
         <menuitem label="Aubergine"/>
         <menuitem label="Choux"/>
         <menuitem label="Carotte" selected="true"/>
         <menuitem label="Tomate"/>
     </menupopup>
 </menulist>

Références

http://www.xulplanet.com/references/elemref/ref_menulist.html

Voir aussi

• menuitem
• listbox et tree, deux autres façons d'afficher des données sous forme de liste.