Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

checkbox

Un élément qui peut être activé ou non. Il est le plus généralement affiché sous la forme d'une case vide lorsque l'élément est désactivé et une case avec une coche lorsqu'il est activé. L'utilisateur peut changer l'état de la case à cocher en la sélectionnant avec la souris. Un label, spécifié avec l'attribut label, peut être ajouté à côté de la case à cocher.

Vous trouverez plus d'informations dans le Tutoriel XUL.

Attributs
accesskey, checked, command, crop, disabled, src, label, preference, tabindex
Propriétés
accessKey, accessibleType, checked, command, crop, disabled, src, label, tabIndex

Exemples

Image:XUL_ref_checkbox.png
<checkbox label="Activer JavaScript" checked="true"/>
<checkbox label="Activer Java" checked="false"/>

Attributs

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

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.
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"/>
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.
preference
Type : id d'élément
Connecte l'élément à une préférence (élément preference) correspondante. Cet attribut n'a d'effet qu'utilisé au sein d'un prefwindow. La valeur de la préférence sera mise à jour pour correspondre à la propriété value de l'élément.
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.

Propriétés

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


accessibleType
Type : entier
Une valeur indiquant le type d'objet d'accessibilité pour l'élément.
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.
label
Type : chaîne de caractères
Obtient et définit la valeur de l'attribut label.
tabIndex
Type : entier
Obtient et définit la valeur de l'attribut tabindex.

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

Interfaces
nsIAccessibleProvider, nsIDOMXULCheckboxElement

Étiquettes et contributeurs liés au document

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