Menuitem

Attributs de la balise

Herités de Reference/Xul/ElementXul

accesskey

Caractère correspondant au raccourci clavier (ALT+caractère). Ce caractère doit être l'un du texte du bouton pour qu'il soit facilement visible (il sera souligné dans le texte).

checked

Indique si la menuitem est cochée ou non.

command

L'id d'un élément command qui est lié à la barre de menu. Si l'attribut "disabled" de l'élément command est mis à "true" (vrai), la menuitem deviendra "disabled" (désactivée). Si l'attribut "disabled" de l'élément command est enlevé, la menuitem sera enabled (active). De la même manière, l'attribut "label" de l'élément command peut être utilisé pour changer l'attribut "label" de la menuitem.

crop

Indique la façon dont est coupé le texte du bouton si ce texte est trop grand par rapport à la taille de l'élement menu. Les valeurs possibles sont :

;start: le début du texte sera coupé et remplacé par des points de suspension. ;end: la fin du texte sera coupé et remplacé par des points de suspension. ;center: Seul le début et la fin du texte apparaitra, ce qui est au milieu en trop sera remplacé par des points de suspension. ;none: le texte ne sera pas coupé, ou alors coupé mais sans points de suspension. Tout dépend des styles CSS de tailles appliqués sur le bouton.

valeurs obsolètes : left, right.

Voir Reference/Xul/label pour voir un exemple.

disabled

Si égale à true, le menu est désactivé (grisé) et non cliquable.

image

Le chemin de l'image qui apparaît sur le menu. Si cet attribut est vide, aucune image s'affiche.La position de l'image est déterminée par les attributs dir et orient.

key

L'id d'un élément key qui est utilisé comme touche de raccourci pour la commande du menu. Si cet attribut est utilisé, le texte sera affiché à côté du texte du menu pour indiquer quelles touches doivent être pressées pour appeler la commande.

label

Le texte du bouton de menu. Si l'attribut est vide, aucun texte s'affiche.

modifiers

Une liste de touches de modification qui doivent être pressées pour appeler l'évènement. Les différentes valeurs doivent être séparées par des espaces ou des virgules. Les touches seront transférées vers d'autres touches sur les plateformes qui ne les ont pas.

;shift: La touche "Shift". ;alt: La touche "Alt". Sur Macintosh, c'est la touche "Option". ;meta: La touche "Meta". Sur Macintosh, c'est la touche "Command". ;control: La touche "Control". ;accel: La touche utilisée pour les raccourcis clavier sur la plateforme de l'utilisateur. Habituellement, ce serait la valeur que vous emploieriez.

name

Les menuitem de type radio ayant le même "name" sont placé dans un groupe. Seul un menuitem de chaque groupe de "radio" peut être coché à la fois.

selected

Indique que la menuitem est sélectionnée dans une menulist. Vous pouvez utiliser cet attribut pour placer la valeur par défaut.

type

Peut-être utilisé pour créer des menuitem cochables ou des menuitems de type bouton "radio"

;checkbox: La menuitem est cochable. L'attribut "checked" détermine si la menuitem est cochée ou non. ;radio: La menuitem devient membre d'un group de boutons "radio". Les autres menuitems qui ont la même valeur pour attribut "name" font partie du même groupe. Seul une menuitem peut être sélectionné à la fois dans un même groupe.

validate Moz0.9.6

Cet attribut indique s'il faut charger l'image du cache ou non. Cela peut être pratique si les images sont stockées sur un serveur distant ou si vous prévoyez de changer les images souvant. Les valeurs suivantes sont acceptées:

;always: La vérification si l'image doit être rechargé est toujours faites. ;never: L'image sera chargé à partir du cache si cela est possible.

value

Vous pouvez associer une valeur à chaque menu et menuitem. Vous pouvez l'utiliser dans un script selon vos besoins.

accesskey

command

crop

disabled

image

label

value

doCommand()

Exécute la commande associée.