mozilla
Vos résultats de recherche

    menu

    Un élément, tout à fait semblable à un élément button, qui est placé dans un élément menubar. Lorsque l'utilisateur clique sur l'élément menu, le menupopup enfant du menu sera affiché. Cet élément est également utilisé pour créer des sous-menus.

    Vous trouverez plus d'informations dans le Tutoriel XUL.

    Attributs
    acceltext, accesskey, allowevents, command, crop, disabled, image, label, menuactive, open, sizetopopup, tabindex, value
    Propriétés
    accessibleType, accessKey, command, control, crop, disabled, image, itemCount, label, labelElement, menupopup, open, parentContainer, selected, tabIndex, value
    Méthodes
    appendItem, getIndexOfItem, getItemAtIndex, insertItemAt, removeItemAt

    Exemple

      <menubar id="sample-menubar">
        <menu id="file-menu" label="Fichier">
          <menupopup id="file-popup">
            <menuitem label="Nouveau"/>
            <menuitem label="Ouvrir"/>
            <menuitem label="Enregistrer"/>
            <menuseparator/>
            <menuitem label="Quitter"/>
          </menupopup>
        </menu>
        <menu id="edit-menu" label="Édition">
          <menupopup id="edit-popup">
            <menuitem label="Annuler"/>
            <menuitem label="Rétablir"/>
          </menupopup>
        </menu>
      </menubar>
    

    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

    Image:XUL_ref_accesskey_attr.png
    <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.
    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.


    Image:XUL_ref_attr_disabled.png
    <!-- 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"/>
    
    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.
    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é.
    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.
    value
    Type : chaîne
    Obtient et définit la valeur de l'attribut value.

    Méthodes

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

    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()

    Sujets liés

    Éléments
    menubar, menuitem, menulist, menupopup, menuseparator
    Interfaces
    nsIAccessibleProvider, nsIDOMXULContainerElement, nsIDOMXULContainerItemElement, nsIDOMXULSelectControlItemElement

    Étiquettes et contributeurs liés au document

    Étiquettes : 
    Contributors to this page:
    Dernière mise à jour par : lmorchard,