input (type="radio") | NN 2 IE 3 DOM 1 | |||||||||||||||||||||||||||||||||||
L'objet radio est un contrôle de formulaire généré à l'aide de l'élément input dont l'attribut type est défini sur "radio". Le même nom est affecté aux objets radio liés. Ceci signifie que tous les objets radio portant le même nom forment une collection (un tableau) d'objets radio. Il peut, par conséquent, s'avérer nécessaire de désigner un bouton radio individuel comme élément d'un tableau. La propriété length applicable à l'ensemble du tableau permet, le cas échéant, de lire en boucle tous les objets radio du groupe, afin de savoir lequel est coché et d´obtenir sa valeur: var radioGrp = document.forms[0].myRadio; for (var i = 0; i< radioGrp.length; i++) { if (radioGrp[i].checked) { alert("The value of the chosen button is " + radioGrp [i].value); } } |
||||||||||||||||||||||||||||||||||||
Les propriétés et méthodes suivantes se rapportent aux boutons radio individuels. |
||||||||||||||||||||||||||||||||||||
Equivalent HTML | ||||||||||||||||||||||||||||||||||||
<input type="radio"> |
||||||||||||||||||||||||||||||||||||
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 | ||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||
Méthodes spécifiques à l´objet | ||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||
Propriétés de gestionnaire d´événements spécifiques à l´objet | ||||||||||||||||||||||||||||||||||||
|
checked | NN 2 IE 3 DOM 1 |
Lecture/écriture | |
Indique si le bouton radio est sélectionné ou activé par l'utilisateur ou le script. Seules les paires nom/valeur des objets radio 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.myRadio[0].checked) { //process first radio button } |
|
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 pour associer un nom de colonne provenant d'une source de données distante à l´attribut value d´un bouton radio déterminé par les propriétés définies dans cet objet. 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.myRadio[0].dataFld = "cableModem"; |
|
Valeur | |
Identifiant de la colonne de la source de données, sous forme de chaîne, 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.myRadio[0].dataSrc = "DBSRC3"; |
|
Valeur | |
Identifiant de la source de données, sous forme de chaîne, 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 checked courant. |
|
Exemple | |
var rBut = document.forms[0].myRadio[0]; if (rBut.checked != rBut.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. |
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 en tant que moitié de la paire nom / valeur (la propriété value du bouton radio en surbrillance indique la 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. Vous devez affecter le même nom à tous les boutons radio d'un groupe dont les caractéristiques de sélection/désélection sont liées. 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, mais les deux éléments doivent avoir la même valeur d´attribut id. Ainsi, si les scripts ont besoin de référencer les éléments par id, créez deux systèmes de noms pour les attributs name communs et les attributs id uniques. |
|
Exemple | |
document.orderForm.myRadio[0].name = "connectivity"; |
|
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].myRadio[0].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 == "radio") { // process radio 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 | |
radio |
value | NN 2 IE 3 DOM 1 |
Lecture/écriture | |
Indique la valeur courante associée au contrôle de formulaire envoyé avec la paire nom/valeur du groupe d'éléments portant le même nom (si le bouton radio spécifique est sélectionné). 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].myRadio[0].value = "56kbps"; |
|
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 | |
|
|
Valeur renvoyée | |
Aucune. |