input (type="text") | NN 2 IE 3 DOM 1
L'objet text est un contrôle de formulaire généré à l'aide de l'élément input dont l'attribut type est paramétré sur "text". Cet objet est le principal moyen d'entrer des lignes de texte à envoyer au serveur.
Equivalent HTML
    <input type="text">
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
dataFld | dataSrc | defaultValue | form | maxLength
name | readOnly | size | type | value
Méthodes spécifiques à l´objet
createTextRange() | handleEvent() | select()
Propriétés de gestionnaire d´événements spécifiques à l´objet
Gestionnaire | NN | IE | DOM
onblur | 2 | 3 | 2
onchange | 2 | 3 | 2
onfocus | 2 | 3 | 2
onkeydown | 4 | 4 | s.o
onkeypress | 4 | 4 | s.o
onkeyup | 4 | 4 | s.o
onselect | 2 | 4 | 2

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 à une propriété value de l'objet text. 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.myText.dataFld = "price";
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.myText.dataSrc = "DBSRC3";
Valeur
Identifiant de la source de données, sous forme de chaîne, sensible à la casse.
Par défaut
Aucune.

defaultValue | NN 2 IE 3 DOM 1
| Lecture seule
Texte par défaut pour l'élément de saisie de texte, défini par l'attribut value.
Exemple
    var txtObj = document.forms[0].myText;
    if (txtObj.value != txtObj.defaultValue ) {
        ...
    }
Valeur
Valeur de chaîne.
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.

maxLength | NN 6 IE 4 DOM 1
| Lecture/écriture
Indique le nombre maximum de caractères pouvant être saisis dans un élément input de type texte. En pratique, les navigateurs préviennent l'utilisateur (par un signal sonore ou un message) lorsque le nombre de caractères saisis dépasse la valeur paramétrée pour maxlength. Il n'existe pas de corrélation directe entre les propriétés maxlength et size. Si maxLength autorise un nombre de caractères supérieur à ce que la largeur de l'élément permet d'afficher, le navigateur assure un défilement horizontal (très peu apprécié de la plupart des utilisateurs) pour autoriser la saisie et la modification du contenu de ce champ.
Exemple
    document.entryForm.myText.maxLength = 35;
Valeur
Valeur, sous forme de nombre entier.
Par défaut
Illimitée.

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.myText.name = "lastName";
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.

readOnly | NN 6 IE 4 DOM 1
| Lecture seule
Détermine si l'élément de formulaire peut être modifié par l'utilisateur. Un script peut modifier un contrôle de formulaire dont la propriété readOnly est true, mais l'utilisateur ne peut pas en modifier le contenu.
Exemple
    if (document.forms[0].myText.readOnly) {
        ...
    }
Valeur
Valeur booléenne: true | false.
Par défaut
false

size | NN 6 IE 4 DOM 1
| Lecture/écriture
En bref, il s'agit de la largeur en caractères que doit avoir le champ de saisie. En pratique, le navigateur ne prévoit pas toujours avec précision la largeur correcte. Reportez-vous aux détails de la section consacrée à l´attribut size dans le chapitre 8 pour l´élément input. Il n´y a pas d´interaction entre les propriétés size et maxLength pour cet objet.
Exemple
    document.forms[0].myText.size = 12;
Valeur
Nombre entier.
Par défaut
20

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 s´avérer 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 == "text") {
        // process text 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
text

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. Toutes les valeurs sont des chaînes. Ceci signifie que les scripts qui utilisent des valeurs de champ de texte pour certaines opérations mathématiques (en particulier, les additions) doivent convertir les chaînes en nombres par le biais des fonctions parseInt() ou parseFloat() avant d'effectuer l'opération mathématique. Si vous affectez un nombre à une propriété value d'un champ de texte, le navigateur convertit immédiatement son type de données en chaîne.
Exemple
    document.forms[0].myText.value = "franken";
Valeur
Chaîne.
Par défaut
Aucune.

createTextRange() | NN s.o. IE 4 (Win) DOM s.o.
Crée un objet TextRange à partir du contenu de l'objet texte. Voir 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
Objet event de Navigator 4.
Valeur renvoyée
Aucune.

select() | NN 2 IE 3 DOM 1
Sélectionne tout le texte affiché dans l'élément formulaire. Vous devez invoquer la méthode focus() sur l´élément avant la méthode select(). De plus, pour résoudre les problèmes de synchronisation potentiels dans IE pour Windows, placez les instructions des méthodes focus() et select() dans une fonction séparée et invoquez cette fonction avec setTimeout(), en général avec un délai de 0 à 50 millisecondes. Cela permet au navigateur d´effectuer les t ches d´actualisation de fenêtres avant de sélectionner le contenu.
Paramètres
Aucune.
Valeur renvoyée
Aucune.