L'objet FORM

La propriété document.forms de l'objet window est un tableau d'objet représentant l'ensemble des formulaires contenus dans le document principal. Ce tableau est formé des éléments:
window.document.forms[0], window.document.forms[1], ..., window.document.forms[window.document.forms.length].
L'indice associé à un lien correspondant à son ordre d'apparition dans le document.

Quelques propriétés

. action: permet de lire ou de modifier l'action associée au formulaire,

. method: permet de lire ou de modifier la méthode d'envoi associée au formulaire,

. target: permet de lire ou de modifier le nom de la fenêtre qui recevra le résultat de l'exécution de l'action associée au formulaire,

. elments: permet d'analyser les objets composant le formulaire:

- elements.length: donne le nombre d'objets composant le formulaire,

- elements[n].name: donne le nom associé au n^{iè me} élément du formulaire,

- elements[n].value: donne la valeur du n^{iè me} élément du formulaire.

Chaque élément de formulaire (zones de texte, listes déroulantes, boutons, ...) possèdent aussi ces propres propriétés et méthodes. Nous parlerons uniquement dans ce document du cas de la balise INPUT (de type texte) et des boutons de soumission.

Exemple 10.
Soit le formulaire suivant:

<FORM METHOD=GET ACTION=traite.cgi>
Entrez un texte:
<INPUT NAME='zone' TYPE=TEXT VALUE='bonjour'>
<INPUT NAME='soumettre' TYPE=SUBMIT VALUE='go'>
</FORM>

En supposant que l'utilisateur rentre au revoir dans la zone de saisie, on a alors (par exemple):

. window.document.forms[0].method = 'get'

. window.document.forms[0].elements[0].value = 'au revoir'

. window.document.forms[0].elements[1].value = 'go'

Quelques méthodes
L'objet FORM ne comporte qu'une seule méthode: submit(). L'appel de cette méthode déclenche la soumission du formulaire comme si l'on cliquait sur le bouton de soumission (elle permet par exemple de déclencher automatiquement la soumission du formulaire lorsque la dernière zone de saisie a été remplie). Les boutons de type RESET possèdent une méthode click() qui réinitialise tout le contenu du formulaire.