input (type="image")

NN 6 IE 4 DOM 1

L´objet de type image input est avant tout un élément de contrôle de formulaire similaire à un bouton, mais il a aussi plusieurs caractéristiques d´un élément img. Son comportement par défaut est celui d´un bouton de type Envoyer. Les coordonnées du clic de la souris dans le rectangle de l´image sont transmises sous la forme de données de formulaire (au format elemName.x=65&elemName.y=44) lors de l´envoi du formulaire. Remarque: Contrairement à la plupart des autres types d´éléments de saisie, ce type de saisie n´était pas définissable par script dans les anciens navigateurs. IE pour Windows risque de ne pas reconnaître une référence à cet élément via le formulaire d´inclusion. Mais l´accès au formulaire par son ID est tout à fait fiable.

Equivalent HTML

<input type="image">

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

alt	complete	dynsrc	form	height
hspace	loop	lowsrc	name	src
start	type	useMap	vspace	width

Méthodes spécifiques à l´objet

handleEvent()

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

Gestionnaire	NN	IE	DOM
onblur	s.o	4	s.o
onclick	2	3	2
onfocus	s.o	4	s.o
onmousedown	4	4	2
onmousemove	6	4	2
onmouseout	6	4	2
onmouseover	6	4	2
onmouseup	4	4	2

complete	NN s.o. IE 4 DOM s.o.
	Lecture seule
Spécifie si le chargement du fichier de type image src ou lowsrc de l'élément input est terminé. Reportez-vous à la propriété complete de l'objet img pour plus de détails.

dynsrc	NN s.o. IE 4 DOM s.o.
	Lecture/écriture
Fournit l´adresse URL d'un clip vidéo à afficher via l´image de l'élément de type image input. Reportez-vous à la propriété dynsrc de l'objet img pour plus de détails.

form	NN 6 IE 4 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.

height, width	NN s.o. IE 4 DOM s.o.
	Lecture/écriture
Indique la hauteur et la largeur en pixels de l´image affichée dans l´élément input. Reportez-vous aux propriétés height et width de l'objet img pour plus de détails.

hspace, vspace	NN s.o. IE 4 DOM s.o.
	Lecture/écriture
Fournit une mesure en pixels des marges horizontale et verticale entourant un objet de type image input. Reportez-vous aux propriétés hspace et vspace de l'objet img pour plus de détails.

alt	NN 6 IE 4 DOM 1
	Lecture/écriture
Indique si le texte affiché (ou lu) à l'endroit où l'élément input apparaît sur la page lorsque le navigateur ne télécharge pas les graphiques (ou attend que le téléchargement soit terminé). Reportez-vous à la propriété alt de l'objet img pour plus de détails.

name	NN 2 IE 3 DOM 1
	Lecture/écriture
Identifiant associé au contrôle du formulaire. La valeur de cette propriété est envoyée avec les coordonnées du clic de la souris (dans le rectangle de l´image) lors de l´envoi du formulaire (au format elemName.x=65&elemName.y=44). Ces coordonnées remplacent la propriété et l´attribut value d´autres types d´éléments input. 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.myButton.name = "Win32";

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.

src	NN 6 IE 4 DOM 1
	Lecture/écriture
Fournit l´URL relative ou complète du fichier image actuellement chargé ou devant être chargé dans l´élément input. Reportez-vous à la propriété src de l'objet img pour plus de détails.

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

Objet event de Navigator 4.

Valeur renvoyée
Aucune.

type	NN 6 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 ê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 == "image") { // process image 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
image

vspace

Voir hspace.

width

Voir height.