| input (type="submit") | NN 2 IE 3 DOM 1 | |||||||||||||||||||||||||||||||||||
L'objet submit est un contrôle de formulaire généré à l'aide de l'élément input dont l'attribut type est paramétré sur "submit". Cet objet est similaire à l'objet button, mais il est plus puissant que ce dernier. L'objet submit envoie automatiquement le formulaire contenant au serveur; aucun script n'est nécessaire. Si, toutefois, vous avez besoin d'un bouton pour exécuter une action de script autre que l'envoi du formulaire, utilisez l'objet button ou l´objet de type bouton input. Autrement, l'objet submit recharge automatiquement le document courant (c´est-à-dire qu´il obéit à l´action par défaut du formulaire, qui est l´URL de la page), au risque de détruire d'importantes variables de script. Pour valider le formulaire, préférez le gestionnaire d'événements onsubmit de l'objet formau gestionnaire d'événements onclick du bouton submit. Si l'évaluation du gestionnaire d'événements renvoie la valeur true, le formulaire est envoyé; si elle renvoie la valeur false, l'envoi est annulé. L´équivalent défini par script d´un objet de type envoi input est la méthode submit() de l´objet form. |
||||||||||||||||||||||||||||||||||||
| Equivalent HTML | ||||||||||||||||||||||||||||||||||||
<input type="submit"> |
||||||||||||||||||||||||||||||||||||
| 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 | ||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||
| form | NN 2 IE 3 DOM 1 |
| Lecture seule | |
Renvoie une référence à l'élément form qui contient l'élément courant. 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. 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. |
|
| Exemple | |
document.orderForm.mySubmit.name = "sender"; |
|
| 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. |
|
| type | NN 3 IE 4 DOM 1 |
| Lecture seule | |
Renvoie le type de l'élément contrôle de formulaire. La valeur est renvoyée en lettres minuscules. Il peut s'avérer nécessaire de parcourir successivement tous les éléments de formulaires à la recherche de types spécifiques à traiter (par exemple, en vidant tous les contrôles de formulaire de type "text" sans modifier les autres). |
|
| Exemple | |
if (document.forms[0].elements[3].type == "submit") {
// process submit 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 | |
submit |
|
| value | NN 2 IE 3 DOM 1 |
| Lecture/écriture | |
C´est l´une des rares occasions au cours de laquelle la propriété value contrôle l´étiquette d´un contrôle de formulaire: à savoir le texte qui s'affiche sur le bouton submit. |
|
| Exemple | |
document.forms[0].mySubmit.value = "Send"; |
|
| Valeur | |
Chaîne. |
|
| Par défaut | |
Submit |
|
| createTextRange() | NN s.o. IE 4 (Win) DOM s.o. |
Crée un objet TextRange contenant le texte de l´étiquette du bouton. Voir 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. |
|