Vos résultats de recherche

menulist

Dans cet article

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

Un élément pouvant être utilisé pour des listes de choix déroulantes. L'utilisateur peut sélectionner l'un des éléments affichés dans la liste menulist. Le choix actuellement sélectionné est affiché sur l'élément menulist lui-même. Pour créer la liste déroulante, ajoutez un élément menupopup dans l'élément menulist, avec les différents choix comme éléments menuitem. L'évènement command peut être utilisé pour exécuter du code lorsque la sélection change dans la liste.

Vous trouverez plus d'informations dans le Tutoriel XUL.

Attributs: accesskey, crop, disableautoselect, disabled, editable, focused, image, label, oncommand, open, preference, readonly, sizetopopup, tabindex, value

Propriétés: accessibleType, crop, description, disableautoselect, disabled, editable, editor, image, inputField, itemCount, label, menuBoxObject, menupopup, open, selectedIndex, selectedItem, tabIndex, value

Méthodes: appendItem, contains, getIndexOfItem, getItemAtIndex, insertItemAt, removeAllItems, removeItemAt, select

Exemples

  <menulist>
    <menupopup>
      <menuitem label="option 1" value="1"/>
      <menuitem label="option 2" value="2"/>
      <menuitem label="option 3" value="3"/>
      <menuitem label="option 4" value="4"/>
    </menupopup>
  </menulist>

Attributs

accesskey: Type : caractère; Cet attribut doit être une lettre utilisée comme touche de raccourci. Cette lettre doit être un des caractères apparaissant dans l'attribut label de l'élément.

Exemple

<vbox>	
  <label value="Entrez votre nom" accesskey="e" control="myName"/>
  <textbox id="myName"/>
  <button label="Annuler" accesskey="n"/>
  <button label="OK" accesskey="O"/>
</vbox>

Voir également

Les attributs label et acceltext

crop: Type : une des valeurs ci-dessous; Si le label de l'élément est trop long pour être contenu dans son espace donné, le texte sera tronqué du côté indiqué par l'attribut crop. Une ellipse (…) sera utilisée à la place du texte tronqué. Si la direction de la boîte est inversée, le tronquage l'est également.

start : Le texte sera tronqué du côté gauche.
end : Le texte sera tronqué du côté droit.
left : Le texte sera tronqué du côté gauche.
right : Le texte sera tronqué du côté droit.
center : Le texte sera tronqué en son milieu, en affichant le début et la fin normalement.
none : Le texte ne sera pas tronqué avec une ellipse. Cependant il sera simplement coupé là où il est trop large. Le côté dépend de l'alignement CSS.

disabled: Type : booléen; Indique si l'élément est ou non désactivé. Si cette valeur est définie à true, l'élément est désactivé. Les éléments désactivés sont habituellement affichés avec leur texte grisé. Si l'élément est désactivé, il ne répond pas aux actions de l'utilisateur, il ne peut pas recevoir le focus, et l'évènement command ne se déclenchera pas.

<!-- La case à cocher active/désactive le bouton -->
<checkbox label="Enable button" 
    onclick="document.getElementById('buttRemove').disabled = this.checked"/>
<button id="buttRemove" label="Remove All" disabled="true"/>

image: Type : URL d'une image; L'URL de l'image devant apparaître sur l'élément. Si cet attribut est vide ou omis, aucune image n'apparaîtra. La position de l'image est déterminée par les attributs dir et orient.

label: Type : chaîne de caractères; Le label qui apparaîtra sur l'élément. S'il n'est pas spécifié, aucun texte n'apparaîtra.

oncommand: Type : code de script; Ce gestionnaire d'évènement est appelé lorsque la commande est activée. Cela se produit quand un utilisateur sélectionne un élément de menu ou active un raccourci clavier attaché à la commande.

open: Type : booléen; Pour les boutons de type menu, l'attribut open est défini à true lorsque le menu est ouvert. L'attribut open n'est pas présent si le menu est fermé.

preference: Type : id d'élément; Connecte l'élément à une préférence (élément preference) correspondante. Cet attribut n'a d'effet qu'utilisé au sein d'un prefwindow. La valeur de la préférence sera mise à jour pour correspondre à la propriété value de l'élément.

readonly: Type : booléen; Si défini à true, l'utilisateur ne peut pas modifier la valeur de l'élément. Cependant, celle-ci peut toujours être modifiée par un script.

tabindex: Type : entier; L'ordre de tabulation de l'élément. L'ordre de tabulation est l'ordre dans lequel le focus se déplace lorsque l'utilisateur appuie sur la touche « tab ». Les éléments dont le tabindex est plus haut se trouvent plus tard dans la séquence de tabulation.

value: Type : chaîne; Cet attribut chaîne permet d'associer une valeur de données avec un élément. Il n'est destiné à aucune utilisation particulière, mais vous pouvez y accéder avec un script pour votre usage propre..

Propriétés

accessibleType: Type : entier; Une valeur indiquant le type d'objet d'accessibilité pour l'élément.

crop: Type : chaîne de caractères; Obtient et définit la valeur de l'attribut crop.

disabled: Type : booléen; Obtient et définit la valeur de l'attribut disabled.

label: Type : chaîne de caractères; Obtient et définit la valeur de l'attribut label.

open: Type : booléen; Obtient et définit la valeur de l'attribut open.

selectedIndex: Type : entier; Renvoie l'indice de l'élément actuellement sélectionné. Un élément peut être sélectionné en assignant son indice à cette propriété. En lui assignant -1, tous les éléments seront désélectionnés.

selectedItem: Type : élément; Conserve l'élément actuellement sélectionné. Si aucun élément n'est sélectionné, sa valeur sera null. Vous pouvez sélectionner un élément en définissant cette valeur. Un évènement select sera envoyé à cet élément lorsqu'il est sélectionné en modifiant cette propriété, la propriété selectedIndex, ou par l'utilisateur.