Objet Window.document.Form


FORM

Permet à l’usager d’entrer du texte et de faire des choix entre les options d’un formulaire. Il est également possible d’utiliser un formulaire pour envoyer des données à un serveur.

Chaque formulaire dans un document représente un objet différent. Il est possible de faire référence à chaque élément d’un formulaire en utilisant le nom de l’élément (par l’attribut NAME) ou en utilisant l’objet "elements array".

Le tableau de formulaires (forms array) :

Il est possible de faire référence à un formulaire dans le code en utilisant le tableau de formulaires. Ce tableau possède une entrée pour chaque objet formulaire (la commande <FORM>) dans un document dans l’ordre du code source. Par exemple, si un document possède trois formulaires, ces derniers seront représentés de cette façon:
document.forms[0]
document.forms[1]
document.forms[2]


Syntaxe:

Pour définir l’objet "form", il faut utiliser la syntaxe HTML habituelle:

<FORM>
..
</FORM>


Pour utiliser les propriétés et les méthodes de l’objet "form":

1. nomFormulaire.nomPropriété
2. nomFormulaire.nomMéthode(paramètres)
3. forms[index].nomPropriété
4. forms[index].nomMéthode(paramètres)

nomFormulaire représente la valeur de l’attribut NAME dans la commande <FORM>.
index est un entier représentant un objet "form".

Pour utiliser un tableau de formulaires (forms array):

1. document.forms[index]
2. document.forms.length

index est un entier représentant un formulaire dans un document.
Pour obtenir le nombre de formulaires dans un document, il faut utiliser la propriété "length".


Objet utilisé:

document


Propriété utilisée:

L’objet "form" possède les propriétés suivantes:

action (représente l’attribut ACTION)

elements (est un tableau qui possède tous les éléments d’un formulaire)
encoding (représente l’attribut ENCTYPE)
length (représente le nombre d’éléments dans un formulaire)
method ( représente l’attribut METHOD)
target ( représente l’attribut TARGET)


Les objets suivants sont aussi des propriétés de l’objet "form":

button
checkbox
FileUpload

hidden
password
radio
reset
select
submit
text
textarea


Le tableau de formulaires possède la propriété suivante:

length (représente le nombre de formulaires dans un document)


Méthode utilisée:

reset
submit


Événement utilisé:

onReset
onSubmit

Exemple FORM

<SCRIPT LANGUAGE="JavaScript">
function testInput (){
if (document.form1.quatrecar.value.length != 4) {
alert("Entrez exactement 4 caractères " + document.form1.quatrecar.value + " n'est pas valide")
}
}
</SCRIPT>

<FORM NAME=form1 onSubmit="testInput()" >
<INPUT TYPE="text" VALUE="1" SIZE=4 NAME=quatrecar>

</FORM>


Christophe Merlet
redfox@redfoxcenter.org
©Tous droits réservés
21 novembre 1998