Please note, this is a STATIC archive of website developer.mozilla.org from November 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

menuseparator

Utilisé pour créer un séparateur entre des éléments de menu. Typiquement affiché sous la forme d'une fine ligne.

Vous trouverez plus d'informations dans le Tutoriel XUL.

Attributs
acceltext, accesskey, allowevents, command, crop, disabled, image, label, selected, tabindex, value
Propriétés
accessibleType, accessKey, command, control, crop, disabled, image, label, labelElement, parentContainer, selected, tabIndex, value

Exemples

<menu label="Aide">
  <menupopup>
    <menuitem label="Rubriques d'aide"/>
    <menuseparator/>
    <menuitem label="Notes de version"/>
  </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

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.
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.


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"/>
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.

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

Sujets liés

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

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : lmorchard, BenoitL
 Dernière mise à jour par : lmorchard,