formNN 2 IE 3 DOM 1

L'objet form représente l'élément form. Un objet form peut être référencé dans tous les navigateurs prenant les scripts en charge, soit par la valeur affectée à son attribut de balise name, soit par l'index de la table de formulaires contenue dans chaque document. Pour les navigateurs qui prennent en charge l´attribut id (IE 4 et versions ultérieures, ainsi que Netscape 6), vous pouvez aussi utiliser les formats de référence d´objets éléments qui utilisent l´ID de l´élément. Pour assembler une référence à un objet de contrôle de formulaire imbriqué (tels que les objets éléments input et textarea), vous pouvez utiliser les références assurant la compatibilité ascendante compatible et qui comprennent l´objet form (comme dans document.formName.controlName) ou vous pouvez référencer l´élément de contrôle directement par son ID spécifique dans les navigateurs plus récents.

 
Equivalent HTML
  
<form>
 
Référence de modèle d'objet
  
[window.]document.formName
[window.]document.forms[i]
[window.]document.form["formName"]
[window.]document.getElementById("elementID")
 
Propriétés spécifiques à l´objet
 
acceptCharsetactionelements[]encodingenctype
lengthmethodnametarget
 
Méthodes spécifiques à l´objet
 
handleEvent()reset()submit()
 
Propriétés de gestionnaire d´événements spécifiques à l´objet
 
EvénementsIE pour WindowsIE pour MacNNDOM W3C
onreset33.0132
onsubmit33.0132
acceptCharsetNN 6 IE 5 DOM 1

Lecture/écriture

Informations, à l'intention des serveurs capables de les interpréter, concernant les jeux de caractères à recevoir d'un formulaire client.

 
Exemple
  
document.entryForm.acceptCharset= "it, es";
 
Valeur

Chaîne insensible à la casse pris dans le registre du jeu de caractères (ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets). Il est possible de délimiter des jeux de caractères multiples par des virgules.

 
Par défaut

Chaîne vide, sauf dans IE pour Windows, avec une valeur par défaut de UNKNOWN.

actionNN 2 IE 3 DOM 1

Lecture/écriture

Fournit l´adresse URL à visiter lors de l'envoi du formulaire. Le contrôle par script de cette propriété permet d'envoyer un même formulaire à plusieurs processus serveur, en fonction de l'interaction de l'utilisateur avec le reste du formulaire. Cette propriété est en lecture seule dans Internet Explorer 3.

 
Exemple
  
document.entryForm.action = "http://www.megacorp.com/cgi-bin/altEntry";
 
Valeur

Adresse URL complète ou relative.
 
Par défaut

Aucune.
elements[]NN 2 IE 3 DOM 1

Lecture seule

Renvoie un tableau de tous les objets contrôle de formulaire que contient le formulaire courant.

 
Exemple
  
for (var i = 0; i < document.entryForm.elements.length; i++) {
    if (document.entryForm.elements[i].type == "text") {
        document.entryForm.elements[i].value = "";
    }
}
 
Valeur

Tableau des références des objets éléments.
 
Par défaut

Tableau de longueur zéro.
encodingNN 2 IE 3 DOM s.o.

Lecture/écriture

Spécifie le type MIME des données envoyées au serveur avec le formulaire. Pour les envois de formulaire courants, avec l'attribut method ayant la valeur post, la valeur par défaut est le type de contenu adéquat. Mais si vous modifiez par script la propriété action d'un formulaire, vous aurez peut-être besoin d'un codage personnalisé. Cette propriété est en lecture seule dans Internet Explorer 3. Voir aussi la propriété encType.

 
Exemple
  
document.orderForm.encoding = "text/plain";
 
Valeur

Valeur de type MIME (type de contenu) sous forme de chaîne non sensible à la casse. Une chaîne peut contenir une liste d'éléments multiples séparés par des virgules.

 
Par défaut

"application/x-www-form-urlencoded" dans IE; chaîne vide dans Netscape 6.

enctypeNN 6 IE 5(Mac)/6(Win) DOM 1

Lecture/écriture

Fournit le nom de la propriété du DOM W3C à ce qui fut la propriété encoding des anciennes implémentations du DOM. Les navigateurs actuels prennent les deux noms de propriété en charge. Voir la propriété encoding.

 
Exemple
  
document.orderForm.enctype = "text/plain";
 
Valeur

Valeur de type MIME (type de contenu) sous forme de chaîne non sensible à la casse. Une chaîne peut contenir une liste d'éléments multiples séparés par des virgules.

 
Par défaut

"application/x-www-form-urlencoded"; chaîne vide dans Netscape 6.

lengthNN 2 IE 3 DOM 1

Lecture seule

Spécifie le nombre d'éléments de contrôle de formulaire dans le formulaire. Vous pouvez utiliser cette propriété à la place de la longueur du tableau elements du formulaire.

 
Exemple
  
for (var i = 0; i < document.forms[0].length; i++)
    ...
}
 
Valeur

Nombre entier.
 
Par défaut

0

methodNN 2 IE 3 DOM 1

Lecture/écriture

Les formulaires peuvent être envoyés selon deux méthodes HTTP: get et post. Ces méthodes déterminent si les données de l'élément formulaire sont transmises au serveur à la suite de l'adresse URL indiquée par l'attribut action (get) ou dans le corps d'un message de transaction (post). Dans la pratique, lorsque les attributs action et method ne sont pas affectés dans un élément form, le formulaire exécute le rechargement inconditionnel du même document, en rétablissant les valeurs par défaut des contrôles de formulaire. La propriété method est en lecture seule dans Internet Explorer 3.

 
Exemple
  
document.entryForm.method = "post";
 
Valeur

L'une des constantes suivantes sous forme de chaîne: get | post.

 
Par défaut

get
nameNN 2 IE 3 DOM 1

Lecture/écriture

Identifiant associé au formulaire. Ces informations ne sont pas envoyées avec le formulaire, mais un nom de formulaire est utilisé dans les références au formulaire et les éléments de formulaire imbriqués. Bien que les normes modernes préfèrent l´attribut id, de nombreux navigateurs nécessitent encore qu´un attribut name soit affecté à un formulaire pour que ce dernier puisse être envoyé.

 
Exemple
  
var firstFormName = document.forms[0].name;
 
Valeur

Identifiant sensible à la casse, 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.

targetNN 2 IE 3 DOM 1

Lecture/écriture

Nom de la fenêtre ou du cadre devant accueillir le contenu renvoyé par le serveur après envoi du formulaire. Ces noms sont affectés aux cadres par l'attribut name de l'élément frame; pour les sous-fenêtres, le nom est affecté par le deuxième paramètre de la méthode window.open(). Comme l´attribut target correspondant n´est pas reconnu par les programmes de validation HTML ou XHTML stricts, vous pouvez omettre cet attribut pour que la validation réussisse, et malgré tout diriger les résultats de formulaires vers une autre fenêtre en affectant une valeur à la propriété target du formulaire dans votre script.

 
Exemple
  
document.getElementById("myForm").target = "_blank";
 
Valeur

Valeur du nom de fenêtre ou de cadre sous forme de chaîne, ou l'une des constantes suivantes (sous forme de chaîne): _parent | _self | _top | _blank. La valeur _parent pointe sur le jeu de cadres dont le document courant fait partie; la valeur _self pointe sur la fenêtre courante; la valeur _top pointe sur la fenêtre principale du navigateur, éliminant ainsi tous les cadres; la valeur _blank (ou tout identificateur inutilisé) crée une nouvelle fenêtre ayant la taille par défaut.

 
Par défaut

Aucun (ce qui implique la fenêtre ou le cadre courant).

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.

 
Paramètres
 
  • Objet event de Navigator 4.
 
Valeur renvoyée

Aucune.
reset()NN 3 IE 4 DOM 1

Revient au même que cliquer sur un élément input de type reset. Les valeurs par défaut de tous les contrôles de formulaire sont rétablies.

 
Paramètres

Aucune.

 
Valeur renvoyée

Aucune.
submit()NN 2 IE 3 DOM 1

Revient au même que cliquer sur un élément input de type submit. Cette méthode ne déclenche pas le gestionnaire d'événements onSubmit dans Navigator ou dans les versions récentes de Microsoft Internet Explorer.

 
Paramètres

Aucune.

 
Valeur renvoyée

Aucune.