menuitem

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

Un choix particulier dans un élément menupopup. Il agit de manière semblable à un élément button, mais est affiché dans un menu.

Vous trouverez plus d'informations dans le Tutoriel XUL.

Attributs: acceltext, accesskey, allowevents, autocheck, checked, command, crop, description, disabled, image, key, label, name, selected, tabindex, type, validate, value

Propriétés: accessibleType, accessKey, command, control, crop, disabled, image, label, labelElement, parentContainer, selected, tabIndex, value

Classes de style: menuitem-iconic, menuitem-non-iconic

Exemple

<menu id="edit-menu" label="Edit">
  <menupopup id="edit-popup">
     <menuitem label="Undo"/>
     <menuitem label="Redo"/>
  </menupopup>
</menu>

Attributs

acceltext: Type : chaîne de caractères; Texte qui apparaîtra à côté du label d'un menu pour indiquer la touche de raccourci (accélérateur) à utiliser pour invoquer la commande. Si cette valeur est définie, elle écrase une clé assignée dans l'attribut key. Cet attribut ne s'applique pas aux menus directement sur la Barre de menus (menubar).

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

allowevents: Type : booléen; Si défini à true, les évènements sont passés aux enfants de l'élément. Dans le cas contraire, ils ne sont passés qu'à l'élément lui-même.

checked: Type : booléen; Indique si l'élément est coché ou non.; Utilisez hasAttribute() pour déterminer si cet attribut est défini plutôt que getAttribute().
Pour les boutons, l'attribut type doit etre mis à checkbox ou à radio pour qu'un effet soit perceptible.

Note : si l'attribut checked est défini à true, et que sa valeur est rendue persistante avec l'attribut persist, Mozilla ne pourra pas conserver cette valeur lorsque l'élément menuitem est désélectionné suite au bug 15232. Pour contourner ceci, définissez l'attribut autocheck à false, puis définissez programmatiquement l'attribut checked lorsque l'utilisateur clique sur l'élément, et définissez-le à false au lieu de retirer l'attribut (c'est-à-dire qu'il faut faire menuitem.setAttribute("checked", "false") au lieu de menuitem.removeAttribute("checked")) lorsque l'utilisateur désélectionne le menuitem, car une valeur à false masquera correctement la marque cochée et conservera son état invisible.

command: Type : id d'élément; Défini à la valeur de l'id d'un élément command observé par l'élément.

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.

selected: Type : booléen; Indique si l'élément est sélectionné ou non. Cette valeur est en lecture seule. Pour changer la sélection, utilisez la propriété selectedIndex ou selectedItem de l'élément conteneur.

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.

accessKey: Type : caractère; Obtient et définit la valeur de l'attribut accesskey.

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.

image: Type : URL d'image; Obtient et définit la valeur de l'attribut image.

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

selected: Type : booléen; La valeur de cette propriété est true si cet élément est sélectionné, ou false s'il ne l'est pas. Cette propriété est en lecture seule.

tabIndex: Type : entier; Obtient et définit la valeur de l'attribut tabindex.

value: Type : chaîne; Obtient et définit la valeur de l'attribut value.

Héritées de XUL element
align, attributes, allowEvents, baseURI, boxObject, builder, childElementCount, childNodes, children, className, clientHeight, clientLeft, clientTop, clientWidth, collapsed, contextMenu, controllers, database, datasources, dir, firstChild, firstElementChild, flex, height, hidden, id, lastChild, lastElementChild, left, localName, maxHeight, maxWidth, menu, minHeight, minWidth, namespaceURI, nextElementSibling, nextSibling, nodeName, nodeType, nodeValue, observes, ordinal, orient, ownerDocument, pack, parentNode, persist, prefix, previousElementSibling, previousSibling, ref, resource, scrollHeight, scrollLeft, scrollTop, scrollWidth, statusText, style, tagName,textContent, tooltip, tooltipText, top, width

Méthodes

Héritées de XUL element
blur, click, doCommand, focus, getElementsByAttribute

Héritées de DOM element
addEventListener(), appendChild(), dispatchEvent(), getAttribute(), getAttributeNode(), getAttributeNodeNS(), getAttributeNS(), getElementsByTagName(), getElementsByTagNameNS(), hasAttribute(), hasAttributeNS(), hasAttributes(), hasChildNodes(), insertBefore(), isSupported(), normalize(), removeAttribute(), removeAttributeNode(), removeAttributeNS(), removeChild(), removeEventListener(), replaceChild(), setAttribute(), setAttributeNode(), setAttributeNodeNS(), setAttributeNS()

Classes de style

menuitem-iconic: Use this class to have an image appear on the menuitem. Specify the image using the image attribute.

menuitem-non-iconic: Normally, menuitems have a margin to the left for an image or checkmark. This class may be used to remove this margin so that the menuitem appears on the left edge of the menupopup.

Sujets liés

Éléments: menu, menubar, menulist, menupopup, menuseparator

Interfaces: nsIAccessibleProvider, nsIDOMXULContainerItemElement, nsIDOMXULSelectControlItemElement

menuitem

Exemple

Attributs

Exemple

Voir également

Propriétés

Méthodes

Classes de style

Sujets liés

Étiquettes et contributeurs liés au document