input (type="button") | NN 2 IE 3 DOM 1 | |||||||||||||||||||||||||||||||||||
L'objet button est un contrôle de formulaire généré à l'aide d´un élément input dont l'attribut type est défini sur "button". L´étiquette de texte du bouton provient de sa propriété et de son attribut value. Quoiqu´il lui ressemble, cet élément diffère de l´élément button. Pour tous détails sur les différences entre ces deux éléments, reportez-vous à la description de l´élément HTML button dans le chapitre 8. |
||||||||||||||||||||||||||||||||||||
Equivalent HTML | ||||||||||||||||||||||||||||||||||||
<input type="button"> |
||||||||||||||||||||||||||||||||||||
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 | ||||||||||||||||||||||||||||||||||||
|
dataFld | NN s.o. IE 4 DOM s.o. |
Lecture/écriture | |
Utilisé avec la liaison de données IE pour associer le nom d'une colonne d'une source de données distante à la propriété value de l'objet button. 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.myButton.dataFld = "linkURL"; |
|
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.myButton.dataSrc = "DBSRC3"; |
|
Valeur | |
Identifiant de la source de données, sensible à la casse. |
|
Par défaut | |
Aucune. |
form | NN 2 IE 3 DOM 1 |
Lecture seule | |
Renvoie une référence à l'élément form qui contient l'élément courant. 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 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.myButton.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. |
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 == "button") { // process button 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 | |
C´est l´une des rares occasions au cours de laquelle la propriété value contrôle l´étiquette d´un contrôle de formulaire: en l´occurrence, le texte qui apparaît dans le bouton. Un élément de saisie de type bouton n'est pas envoyé avec le formulaire. |
|
Exemple | |
document.forms[0].myButton.value = "Undo"; |
|
Valeur | |
Chaîne. |
|
Par défaut | |
Aucune. |
createTextRange() | NN s.o. IE 4 (Win) DOM s.o. |
Crée un objet TextRange contenant le texte de l´étiquette du bouton. Reportez-vous à l'objet TextRange pour plus de détails. |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Objet TextRange. |
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. |