input (type="checkbox") | NN 2 IE 3 DOM 1
L'objet checkbox est un contrôle de formulaire généré à l'aide de l'élément input dont l'attribut type est paramétré sur "checkbox". Utilisez cet élément uniquement comme un élément d´interface utilisateur pour les choix « activé/désactivé » de l´utilisateur, pas comme un bouton de navigation. Dans IE 5 et versions ultérieures pour Windows ainsi que dans Netscape 6, vous pouvez modifier la taille de la case à cocher avec les attributs de hauteur et de largeur de feuille de style, mais seul Netscape 6 met automatiquement à l´échelle la taille de la coche optimisée pour la taille du rectangle de la case à cocher et maintient les lignes du texte environnant en parfait alignement avec le bas du rectangle.
Equivalent HTML
    <input type="checkbox">
Référence de modèle d'objet
    [window.]document.formName.elementName
    [window.]document.forms[i].elements[i]
    [window.]document.getElementById("elementID")
Propriétés spécifiques à l´objet
checked | dataFld | dataSrc | defaultChecked | form
indeterminate | name | status | type | value
Méthodes spécifiques à l´objet
handleEvent()
Propriétés de gestionnaire d´événements spécifiques à l´objet
Gestionnaire | NN | IE | DOM
onblur | 6 | 4 | 2
onclick | 3 | 4 | 2
onfocus | 6 | 4 | 2
onmousedown | 4 | 4 | 2
onmousemove | 6 | 4 | 2
onmouseout | 6 | 4 | 2
onmouseover | 6 | 4 | 2
onmouseup | 4 | 4 | 2

checked | NN 2 IE 3 DOM 1
| Lecture/écriture
Indique si la case à cocher est sélectionnée ou activée par l'utilisateur (ou le script). Les cases à cocher opèrent indépendamment les unes des autres. Seules les paires nom / valeur des objets checkbox dont la propriété checked est paramétrée sur true sont transmises avec le formulaire. Voir la propriété defaultChecked pour savoir si l'élément de formulaire est activé lors du chargement de la page. Les scripts peuvent modifier cette propriété même si l´élément est désactivé.
Exemple
    if (document.choiceForm.monitors.checked) {
        //process for the "monitors" checkbox being checked
    }
Valeur
Booléenne: true | false.
Par défaut
false

dataFld | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
Utilisé avec la fonction de liaison de données de Microsoft Internet Explorer 4 pour associer un nom de colonne provenant d'une source de données distante à l'attribut value de l'objet checkbox. Vous devez également définir un attribut datasrc pour l'élément. Le paramétrage des deux propriétés dataFld et dataSrc sur des chaînes vides rompt la liaison entre l'élément et la source de données. Fonctionne uniquement avec les sources de données de fichiers sources dans IE 5/Mac.
Exemple
    document.myForm.myCheckbox.dataFld = "homeAddrFlag";
Valeur
Identifiant de la colonne de la source de données, sensible à la casse.
Par défaut
Aucune.

dataSrc | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
Utilisé avec la fonction de liaison de données de Microsoft Internet Explorer pour spécifier l´ID de l´élément object de la page qui charge l´objet de source de données pour l´accès distant aux données. Le contenu à extraire de la source de données est spécifié à l'aide de l'attribut datafld. Le paramétrage des deux propriétés dataFld et dataSrc sur des chaînes vides rompt la liaison entre l'élément et la source de données. Fonctionne uniquement avec les sources de données de fichiers sources dans IE 5/Mac.
Exemple
    document.myForm.myCheckbox.dataSrc = "DBSRC3";
Valeur
Identifiant de la source de données, sensible à la casse.
Par défaut
Aucune.

defaultChecked | NN 2 IE 3 DOM 1
| Lecture/écriture
Indique si l'attribut checked de l'élément est paramétré dans la balise. Vous pouvez comparer la propriété checked actuelle à defaultChecked pour savoir si l'état du contrôle a été modifié depuis le chargement du document. La modification de cette propriété n'affecte pas l'état courant de la propriété checked.
Exemple
    var cBox = document.forms[0].checkbox1
    if (cBox.checked != cBox.defaultChecked) {
        // process for changed state
    }
Valeur
Valeur booléenne: true | false.
Par défaut
Déterminé par l'attribut de balise HTML.

form | NN 2 IE 3 DOM 1
| Lecture seule
Renvoie une référence à l'élément form qui contient l'élément courant (le cas échéant). Lors du traitement d´un événement à partir de cet élément, la fonction de gestionnaire d´événements a automatiquement accès à l´élément input (en tant que propriété target ou srcElement de l´objet événement). En lisant la propriété form, le script peut facilement accéder à d´autres contrôles dans le même formulaire.
Exemple
    var theForm = evt.srcElement.form;
Valeur
Référence de l'objet élément form.
Par défaut
Aucune.

indeterminate | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
Indique si une case à cocher est représentée visuellement comme n'étant ni activée, ni désactivée mais active malgré tout. Cet état intermédiaire s'affiche différemment selon les systèmes d'exploitation. Dans Windows, la case à cocher est grisée (la marque est toujours visible si elle l'était initialement) et toujours active. Sur Macintosh, la case à cocher affiche un tiret. L'état indéterminé signifie généralement qu'une modification effectuée à un autre endroit de la page a probablement affecté le paramétrage de la case à cocher, obligeant l'utilisateur à vérifier s'il est correct. La case à cocher "indeterminate" est envoyée avec le formulaire.
Exemple
    document.orderForm.2DayAir.indeterminate = true;
Valeur
Valeur booléenne: true | false.
Par défaut
false

name | NN 2 IE 3 DOM 1
| Lecture/écriture
Identifiant associé au contrôle du formulaire. Lors de l'envoi du formulaire au serveur, la valeur de cette propriété est envoyée comme une moitié de la paire nom / valeur. Les noms sont masqués à la vue de l'utilisateur, les étiquettes de contrôle étant affectées par d'autres moyens, en fonction du type de contrôle. Les noms de contrôle de formulaire peuvent également être utilisés dans des instructions de script faisant référence à des objets. Bien que les normes modernes préfèrent l´attribut id, de nombreux navigateurs nécessitent encore qu´un attribut name soit affecté à un contrôle de formulaire pour que la valeur de ce dernier puisse être envoyée.
Exemple
    document.orderForm.myCheckbox.name = "Win32";
Valeur
Identifiant sensible à la casse, sous forme de chaîne, conforme aux règles de dénomination des identifiants: il ne peut pas contenir d'espace blanc ni de signe de ponctuation, à l'exception du caractère de soulignement, et ne peut pas commencer par un chiffre.
Par défaut
Aucune.

status | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
Détermine si l'élément est en surbrillance/activé. Cette propriété est identique à la propriété checked.
Exemple
    if (document.forms[0].56KbpsBox.status) {
        ...
    }
Valeur
Valeur booléenne: true | false.
Par défaut
Aucune.

type | NN 3 IE 4 DOM 1
| Lecture seule
Renvoie le type de l'élément contrôle de formulaire. La valeur renvoyée s'affiche en lettres minuscules. Il peut être nécessaire de parcourir successivement tous les éléments du formulaire à la recherche de types spécifiques à traiter (par exemple vider tous les contrôles de formulaire de type "text" sans modifier les autres contrôles).
Exemple
    if (document.forms[0].elements[3].type == "checkbox") {
        // process checkbox input type here
    }
Valeur
L'une des constantes suivantes (sous forme de chaîne): button | checkbox | file | hidden | image | password | radio | reset | select-multiple | select-one | submit | text | textarea.
Par défaut
checkbox

value | NN 2 IE 3 DOM 1
| Lecture/écriture
Fournit la valeur courante associée au contrôle de formulaire envoyé avec la paire nom/valeur de cet élément (si la case à cocher est activée). Toutes les valeurs sont des chaînes, mais elles peuvent représenter d'autres types de données, notamment des valeurs booléennes et numériques.
Exemple
    document.forms[0].extraPhone.value = "cellPhone";
Valeur
Chaîne.
Par défaut
Aucune.

handleEvent() | NN |4| IE s.o. DOM n/a
handleEvent(événement) |
Indique à l'objet qu´il doit accepter et traiter l'événement dont les spécifications sont passées à la méthode sous forme de paramètre. Pour pouvoir traiter l'événement, l'objet doit disposer d'un gestionnaire d'événements pour ce type d'événement. Navigator 4 uniquement.
Paramètres
Objet event de Navigator 4.
Valeur renvoyée
Aucune.