input (type="password") | NN 2 IE 3 DOM 1 | |||||||||||||||||||||||||||||||
L'objet password est un contrôle de formulaire généré à l'aide de l'élément input dont l'attribut type est paramétré sur "password". Cet objet est similaire à l'objet de saisie de texte, à la différence près que les caractères tapés dans la zone de texte par l'utilisateur sont convertis en astérisques ou en puces afin d'en préserver la confidentialité. |
||||||||||||||||||||||||||||||||
Equivalent HTML | ||||||||||||||||||||||||||||||||
<input type="password"> |
||||||||||||||||||||||||||||||||
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 fonction de liaison de données de Microsoft Internet Explorer pour associer un nom de colonne provenant d'une source de données distante à la propriété value de l'objet de mot de passe. 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.myPassword.dataFld = "userWurd"; |
|
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.myPassword.dataSrc = "#DBSRC3"; |
|
Valeur | |
Identifiant de la source de données, sensible à la casse. |
|
Par défaut | |
Aucune. |
defaultValue | NN 2 IE 3 DOM 1 |
Lecture seule | |
Indique le texte par défaut pour l'élément de saisie du mot de passe, tel que défini par l'attribut value. |
|
Exemple | |
var pwObj = document.forms[0].myPassword; if (pwObj.value != pwObj.defaultValue ) { // process user-entered password } |
|
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 (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. |
maxLength | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Spécifie le nombre maximal de caractères pouvant être saisis dans un élément input de type mot de passe. 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.myPassword.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.myPassword.name = "pw"; |
|
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].myPassword.readOnly ) { ... }; |
|
Valeur | |
Valeur booléenne: true | false. |
|
Par défaut | |
false |
selectionEnd, selectionStart | NN 6 IE s.o. DOM s.o. |
Lecture/écriture | |
Les propriétés selectionEnd et selectionStart ont été introduites par Netscape 6 pour une plus grande commodité. Elles permettent aux scripts d´obtenir et de définir les positions de début et de fin d´une sélection de texte dans un élément de saisie axé sur le texte. Les valeurs sont des compteurs de positions (sous la forme de nombres entiers à base zéro) entre les caractères dans le texte saisi dans le champ. Quand les deux propriétés ont la même valeur, le résultat visuel est le même que celui d´un pointeur d´insertion de texte. Par exemple, pour placer le curseur à la fin d´une zone de texte, définissez les deux valeurs sur la longueur du texte de l´événement (voir la propriété textLength). La fonctionnalité IE équivalente nécessite la création d´une plage de texte IE dans l´élément, la modification des points de début et de fin de la plage et la sélection de la plage (voir l´objet TextRange). |
|
Exemple | |
var elem = document.forms[0].myPassword; elem.selectionEnd = elem.textLength; elem.selectionStart = elem.textLength; |
|
Valeur | |
Entier positif. |
|
Par défaut | |
Aucune. |
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. Dans la pratique, le navigateur ne prévoit pas toujours la largeur correcte, même lorsque tous les caractères sont identiques, comme c'est le cas de l'objet password. 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].myPassword.size = 12; |
|
Valeur | |
Nombre entier. |
|
Par défaut | |
20 |
textLength | NN 6 IE s.o. DOM s.o. |
Lecture seule | |
La propriété textLength (introduite avec Netscape 6) renvoie la longueur du texte saisi dans le champ de texte. La valeur est identique à la longueur de la propriété value. |
|
Exemple | |
var elem = document.forms[0].myPassword; elem.selectionEnd = elem.textLength; elem.selectionStart = elem.textLength; |
|
Valeur | |
Entier positif. |
|
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 == "password") { // process password 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 | |
password |
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. Les navigateurs (à l'exception de Navigator 2) renvoient les caractères réels tapés par l'utilisateur. Il vous est donc possible de récupérer un mot de passe saisi pour tout traitement ultérieur avant soumission (ou pour le stocker dans le cookie). |
|
Exemple | |
document.forms[0].myPassword.value = "franken"; |
|
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 la valeur du champ. 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. |
select() | NN 2 IE 3 DOM 1 |
Sélectionne tout le texte affiché dans l'élément formulaire. Nécessite généralement que l´élément soit actif avant que la méthode soit invoquée. |
|
Paramètres | |
Aucune. |
|
Valeur renvoyée | |
Aucune. |