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'attributkey
. 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
de l'élément.label
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
-
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ènementcommand
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"/>
-
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
ouselectedItem
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.
selected
- Type : booléen
- La valeur de cette propriété est
true
si cet élément est sélectionné, oufalse
s'il ne l'est pas. Cette propriété est en lecture seule.
Méthodes