Manuel de référence du programmeur XUL

<menu>

Attributs Enfants communs
value <menupopup>
flex <menuseparator />
key <separator /> 
disabled  
id  
class  
acceltext  
accesskey  
crop  
orient  
autostretch  
oncommand  

L'élément <menu> apparaît habituellement en tant qu'enfant de <menubar>, mais pas obligatoirement. Popup menus à divers endroits: comme menus de contexte recouvrant le contenu, en bas du browser et ainsi de suite. Typiquement, un menu a un <menupopup> en tant qu'enfant. Un menu peut contenir un menupopup simple en tant qu'enfant direct, bien que des sous-menus puissent être définis en créant des menus comme enfants des menupopups. Dans le menupopup, un certain nombre d'éléments du menu sont définis. Un menu de fichier simple est défini comme suit:

 
<menu value="File">
    <menupopup>
       <menuitem value="Open" />
       <menuitem value="Close" oncommand="window.close()"/>
       <menuseparator/>
       <menuitem value="Save" />
       <menuitem value="Exit"/>
    </menupopup>
</menu>
value
Description
value est un attribut exigé utilisé pour nommer l'élément de menu. 
Syntaxe
<menu value="string" />
Exemple
<menu value="File" /


Notes

Aucune.
 
accesskey
Description
accesskey est un attribut facultatif pour indiquer un raccourci clavier pour un menu ou un menuitem. 
Syntaxe
<menu id="string" accesskey="character">


Exemple

<menu id="formatMenu" value="&formatMenu.label;" accesskey="&formatmenu.accesskey;">
    <menupopup id="formatMenuPopup">
      <menuitem id="pageProperties"/>
    </menupopup>
</menu>


Notes

Les menus peuvent avoir des  clés et des raccourcis claviers définis. La clé de raccourci est une lettre simple qui peut être employée (sur n'importe quelle plateforme) pour accéder rapidement au menu en  combinaison avec une autre clé (par exemple, ALT). L'attribut pour indiquer cette clé est accesskey. Notez que accesskey devrait utiliser une entité localisée, comme dans l'exemple ci-dessus, pour s'assurer du caractère avec les touches disponibles sur le clavier.


 

disabled
Description
disabled est un attribut facultatif utilisé pour griser des menus et des menuitems.


Syntaxe

<menu id="string" disabled="true | false" >
Exemple
<menu id="Edit" disabled="true" >
Notes
Maintenir à jour et contrôler  l'état disabled pour voir si certaines exécutions de menu sont disponibles, comme dans l'exemple suivant:
 
XXX INsert example from help stuff here XXX.
                        
acceltext
Description
acceltext est un attribut facultatif employé pour ignorer l'accès accéléré construit pour un menu ou un menuitem.
Syntaxe
<menu id="string" acceltext="string" >
Exemple
<menu id="Edit" acceltext="<Ctrl> + <X> (Cut)" >
Notes
L'accélérateur de texte est produit automatiquement en lançant la touche <key> et toutes les clés de modificateur (par exemple, la touche de commande). Quand vous n'indiquez pas l'attribut acceltext pour un élément principal défini en tant que <key id="skip" key="s" and alt="true" />, par exemple, l'acceltext est S+Alt; si vous assurez une valeur d'acceltext pour cette clé, alors cette valeur ignore le texte par défaut.
 
key
Description
key est un attribut l facultatif employé pour indiquer une clé liée au menu.


Syntaxe

<menu id="string" key="key identifier" >
Exemple
<menu id="Save" key="saveKey" >
Notes
Aucune.
 
crop
Description
crop est un attribut facultatif pour indiquer quelle partie du texte d'un menu, le cas échéant, sera coupée si il est trop grand.
Syntaxe
<menu id="string" value="Nom de Menu" crop="left | right | none" >
Exemple
<menu id="string" value="Très long nom de Menu" crop="none" >
Notes
Aucune.

 
Last updated: 3/27/00 Ian Oeschger
French version (7/3/00) Matthieu Camus