input (type="hidden")

NN 3 IE 4 DOM 1

L'objet hidden est un contrôle de formulaire généré à l'aide de l'élément input dont l'attribut type est paramétré sur "hidden". Cet élément est dépourvu de gestionnaire d'événements, car il n'existe aucune interactivité directe entre l'utilisateur et l'élément. Sachez que toute valeur affectée à un objet hidden est supprimée si l'utilisateur recharge la page. Autrement dit, cet élément n'est pas stocké de façon permanente. Internet Explorer pour Windows et Netscape 6 présentent beaucoup plus de propriétés que celles qui sont répertoriées ci-dessous. La plupart de ces propriétés sont incluses dans la définition d'objet interne pour assurer la cohérence entre différents contrôles de formulaires de type textuel, mais n'ont pas de signification particulière pour un objet hidden.

Equivalent HTML

<input type="hidden">

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

name

type

value

Méthodes spécifiques à l´objet

createTextRange()

Propriétés de gestionnaire d´événements spécifiques à l´objet

Aucune.

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 valeur d'un élément. 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.price.dataFld = "price";

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 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.price.dataSrc = "DBSRC3";

Valeur
Identifiant de la source de données, sensible à la casse.

Par défaut
Aucune.

defaultValue	NN 2 IE 3 DOM s.o.
	Lecture seule
Renvoie la chaîne affectée à l´attribut value de l´élément dans le code source. Vous pouvez utiliser cette valeur pour réaffecter la valeur d´origine à l´élément si les scripts ont modifié la propriété value pendant d´autres traitements.

Exemple

document.entryForm.sessionID.value = document.entryForm.sessionID.defaultValue;

Valeur
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.

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.compName.name = "company";

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.

createTextRange()	NN s.o. IE 4 (Win) DOM s.o.

Crée un objet TextRange contenant la valeur de chaîne du champ caché. Reportez-vous à l'objet TextRange pour plus de détails.

Paramètres
Aucune.

Valeur renvoyée
Objet TextRange.

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 == "hidden") { // process hidden 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
hidden