img | NN 3 IE 4 DOM 1
L'objet img représente l'élément img. Cet objet partage les mêmes propriétés que l´objet Image statique, que vous pouvez utiliser pour pré-positionner les images en mémoire cache sans les afficher sur la page.
Equivalent HTML
    <img>
Référence de modèle d'objet
    [window.]document.imageName
    [window.]document.images[i]
    [window.]document.images["imageName"]
    [window.]document.getElementById("elementID")
Propriétés spécifiques à l´objet
align | alt | border | complete
dataFld | dataFormatAs | dataSrc | dynsrc
fileCreatedDate | fileModifiedDate | fileSize | fileUpdatedDate
height | href | hspace | isMap
longDesc | loop | lowsrc | lowSrc
mimeType | name | nameProp | naturalHeight
naturalWidth | protocol | prototype | src
start | useMap | vspace | width
x | y |  |
Méthodes spécifiques à l´objet
Aucune.
Propriétés de gestionnaire d´événements spécifiques à l´objet
Evénements | IE pour Windows | IE pour Mac | NN | DOM W3C
onabort | 4 | 4 | 3 | 2
onerror | 4 | 4 | 3 | 2
onload | 4 | 4 | 3 | s.o

align | NN 6 IE 4 DOM 1
| Lecture/écriture
Définit l'alignement de l'élément par rapport au contenu du texte environnant. La plupart des valeurs définissent la relation verticale existant entre l'élément et le texte environnant. Par exemple, pour aligner le bas de l'élément sur la ligne de base du texte environnant, la valeur de la propriété align doit être baseline. Un élément peut “ flotter ” le long de la marge de gauche ou de droite pour permettre au texte environnant de l'entourer.
Exemple
    document.logoImg.align = "absmiddle";
Valeur
L'une des constantes d´alignement suivantes (sous forme de chaîne): absbottom | absmiddle | baseline | bottom | right | left | none | texttop | top.
Par défaut
bottom

alt | NN 6 IE 4 DOM 1
| Lecture/écriture
Indique si le texte affiché (ou lu) à l'endroit où l'élément img apparaît sur la page lorsque le navigateur ne télécharge pas les graphiques (ou attend que le téléchargement soit terminé). En principe, le texte doit contenir une brève description de l'image. Sachez que la taille de la zone dévolue à l'image sur la page peut limiter la longueur du texte visible sur cette page. Vérifiez que toute la description est lisible.
Exemple
    document.corpLogo.alt = "MegaCorp Logo";
Valeur
Valeur de chaîne.
Par défaut
Aucune.

border | NN 3 IE 4 DOM 1
| Lecture/écriture (IE et Netscape 6)
Fournit l´épaisseur, en pixels, de la bordure entourant un élément. Cette propriété est en lecture seule dans Navigator 4.
Exemple
    document.logoImage.border = 4;
Valeur
Un nombre entier. La valeur zéro supprime totalement la bordure.
Par défaut
0

complete | NN 3 IE 4 DOM s.o.
| Lecture seule
Spécifie si le chargement du fichier image src ou lowsrc de l'élément img est terminé. Remarque: Navigator 4 renvoie une valeur true incorrecte avant la fin du chargement de l'image.
Exemple
    if (document.logo.complete) {
        // safe to process the image object
    }
Valeur
Valeur booléenne: true | false.
Par défaut
false

dataFld | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
Utilisé avec la fonction de liaison de données de Microsoft Internet Explorer pour associer un nom de colonne provenant d'une source de données distante à la propriété src de l'objet img. Vous devez également définir un attribut datasrc pour l'élément. Le paramétrage des deux propriétés dataFld et dataSrc sur des chaînes vides rompt la liaison entre l'élément et la source de données. Fonctionne uniquement avec les sources de données de fichiers sources dans IE 5/Mac.
Exemple
    document.myImage.dataFld = "logoURL";
Valeur
Identifiant de la colonne de la source de données, sensible à la casse.
Par défaut
Aucune.

dataFormatAs | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
Cette propriété est un élément de l´objet élément img dans IE, mais ne s´applique pas à img car les valeurs de liaison de données sont liées à l´attribut src, et non au contenu affiché.

dataSrc | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
Utilisé avec la fonction de liaison de données de Microsoft Internet Explorer pour spécifier l´ID de l´élément object de la page qui charge l´objet de source de données pour l´accès distant aux données. Le paramétrage des deux propriétés dataFld et dataSrc sur des chaînes vides rompt la liaison entre l'élément et la source de données. Fonctionne uniquement avec les sources de données de fichiers sources dans IE 5/Mac.
Exemple
    document.myImage.dataSrc = "DBSRC3";
Valeur
Identifiant de la source de données, sensible à la casse.
Par défaut
Aucune.

dynsrc | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
Adresse URL d'un clip vidéo à afficher via l'élément img. La modification de cette propriété entraîne le chargement d'un nouveau clip vidéo dans l'objet image. Voir également la propriété loop permettant de contrôler la fréquence de lecture du clip vidéo.
Exemple
    document.images[3].dynsrc = "snowman.avi";
Valeur
Adresse URL complète ou relative, sous forme de chaîne.
Par défaut
Aucune.

fileCreatedDate | NN s.o. IE 4(Win)/5(Mac) DOM s.o.
| Lecture seule
Renvoie une chaîne de la date (pas de l´heure) à laquelle le serveur (ou système de fichiers local) indique que le fichier actuellement chargé a été créé. En chargeant une image dans un objet Image non affiché, un script peut déterminer la date de l´image (mais il peut le faire plus précisément à partir de la propriété fileUpdatedDate). Dans IE 4, la valeur est au format de date longue, mais à partir de IE 5, les informations de date sont formatées comme suit: mm/jj/aaaa. La valeur risque d´être corrompue si le serveur les données dans un format auquel IE ne s´attend pas. Implémentée dans IE 5 pour Mac, mais la valeur est vide.
Exemple
    var dateObj = new Date(document.logoImg.fileCreatedDate);
Valeur
chaîne Date
Par défaut
Aucune.

fileModifiedDate | NN s.o. IE 4(Win)/5(Mac) DOM s.o.
| Lecture seule
Renvoie une chaîne de la date (pas de l´heure) à laquelle le serveur (ou système de fichiers local) indique que le fichier actuellement chargé a été modifié pour la dernière fois. Dans IE 4, la valeur est au format de date longue, mais à partir de IE 5, les informations de date sont formatées comme suit: mm/jj/aaaa. La valeur risque d´être corrompue ou incorrecte si le serveur les données dans un format auquel IE ne s´attend pas. Implémentée dans IE 5 pour Mac, mais la valeur est vide.
Exemple
    var dateObj = new Date(document.logoImg.fileModifiedDate);
Valeur
chaîne Date
Par défaut
Aucune.

fileSize | NN s.o. IE 4(Win)/5(Mac) DOM s.o.
| Lecture seule
Renvoie le nombre d´octets pour la taille de l´image actuellement chargée. IE pour Windows renvoie cette valeur sous la forme d´une chaîne, alors qu´IE pour Mac la renvoie sous la forme d´une valeur numérique (bien que sa valeur soit 0).
Exemple
    var byteCount = parseInt(document.fileSize, 10);
Valeur
Nombre entier sous la forme d´une chaîne (Windows) ou d´un nombre (Mac).
Par défaut
Aucune.

filters[] | NN s.o. IE 4 DOM s.o.
Renvoie un tableau de tous les objets filter que contient l´élément courant. Ne s´applique qu´aux objets éléments suivants: bdo , body , button , div , fieldset , img , input , marquee , rt , ruby , span , table , td , textarea et th . Voir l'objet filter pour la syntaxe de référencement.
Valeur
Tableau des références des objets filter .
Par défaut
Tableau de longueur zéro.

fileUpdatedDate | NN s.o. IE 5(Mac)/5.5(Win) DOM s.o.
| Lecture seule
Pour un fichier image obtenu à partir d´un serveur, cette propriété peut refléter plus précisément la date à laquelle le fichier a été chargé sur le serveur que les autres propriétés ayant trait à la date. Les fichiers locaux renvoient souvent une chaîne vide. Implémentée dans IE 5 pour Mac, mais la valeur est vide.
Exemple
    var dateObj = new Date(document.logoImg.fileUpdatedDate);
Valeur
chaîne Date
Par défaut
Aucune.

height, width | NN 3 IE 4 DOM 1
| Lecture/écriture (IE et Netscape 6)
Indique la hauteur et la largeur en pixels de l´image affichée dans l´élément img. Dans Internet Explorer 4 (ou les versions ultérieures), les modifications apportées à ces valeurs se reflètent immédiatement dans le contenu actualisé de la page. L'échelle des images est adaptée à la nouvelle dimension.
Exemple
    document.prettyPicture.height = 250;
Valeur
Nombre entier.
Par défaut
Aucune.

href | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
Adresse URL déterminée par l'attribut src de l'élément. Cette propriété est identique et délaissée au profit de la propriété src.
Exemple
    document.logoImage.href = "images/fancyLogo.gif";
Valeur
Chaîne d'une adresse URL complète ou relative.
Par défaut
Aucune.

hspace, vspace | NN 3 IE 4 DOM 1
| Lecture/écriture (IE et Netscape 6)
Fournit une mesure en pixels des marges horizontales et verticales entourant un objet image. La propriété hspace affecte de façon identique les côtés gauche et droit de l'élément; la propriété vspace affecte de façon identique les côtés haut et bas de l'élément. Ces marges diffèrent de celles définies dans les feuilles de style, mais leur aspect visuel est identique.
Exemple
    document.logo.hspace = 5;
    document.logo.vspace = 8;
Valeur
Nombre entier de pixels.
Par défaut
0 (IE); -1 (Netscape 6).

isMap | NN 6 IE 4 DOM 1
| Lecture/écriture
Indique si l'élément img se comporte comme une carte image côté serveur. Pour qu'une image fasse office de carte image côté serveur, elle doit être incluse dans un élément a dont l'attribut href pointe sur l'adresse URL du programme CGI capable d'interpréter les informations relatives aux coordonnées du point cliqué. Le navigateur ajoute les informations relatives aux coordonnées du point cliqué à l'adresse URL, tout comme la méthode get d'un formulaire ajoute les données relatives à un élément de formulaire à l'adresse URL de l'attribut action.
Les navigateurs récents permettent d'utiliser des cartes graphiques côté client (voir la propriété useMap) capables d'opérer plus rapidement parce qu'elles ne doivent plus communiquer avec le serveur pour examiner les coordonnées du point cliqué.
Exemple
    document.navMap.isMap = true;
Valeur
Valeur booléenne: true | false.
Par défaut
false

longDesc | NN 6 IE 5(Mac)/6(Win) DOM 1
| Lecture/écriture
Représente l´attribut longDesc de l'élément img. Les navigateurs version 6 ne fournissent aucune fonctionnalité significative pour cet attribut ou propriété.
Valeur
Chaîne URL.
Par défaut
Une chaîne vide.

loop | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
Si vous avez spécifié un clip vidéo à l'aide de l'attribut dynsrc, la propriété loop permet de contrôler le nombre de lectures (en boucle) du clip. La valeur -1 équivaut à une boucle continue.
Exemple
    document.movieImg.loop = 3;
Valeur
Nombre entier.
Par défaut
1

lowsrc | NN 3 IE 4 DOM s.o.
| Lecture/écriture (IE et Netscape 6)
Indique l´adresse URL d'une image de faible résolution (ou image alternative) à charger dans l'espace du document prévu à cet effet, si le téléchargement de l'image de l'attribut src s'annonce trop long. L'image lowsrc doit en principe avoir la même taille, en pixels, que l'image src principale. Ne modifiez la propriété lowsrc que si vous modifiez également la propriété src. Dans ce cas, veillez à modifier d'abord la propriété lowsrc pour indiquer au navigateur comment gérer le long téléchargement de l'image src.
Remarque: Netscape 6 implémente aussi une deuxième variante de cette propriété avec une mise en majuscules différente: lowSrc. Aucune de ces versions n´est indiquée dans le DOM W3C.
Exemple
    document.productImage.lowsrc = "images/widget43LoRes.jpg";
Valeur
Toute adresse URL complète ou relative sous forme de chaîne.
Par défaut
Aucune.

mimeType | NN s.o. IE 6 (Win) DOM s.o.
| Lecture seule
Renvoie une description en anglais du type MIME pour l´image. La propriété n´est peut-être pas officiellement prise en charge par Microsoft, mais elle rapporte correctement les valeurs pour les types d´images typiques en provenance des disques locaux et des serveurs.
Exemple
    if (document.productImage.mimeType.indexOf("JPEG") != -1) {
        // process condition for jpeg image
    }
Valeur
Valeur sous forme de chaîne telle que JPEG Image ou GIF Image.
Par défaut
Aucune.

name | NN 2 IE 3 DOM 1
| Lecture/écriture
Identifiant associé à l'objet image en vue de son utilisation dans des instructions de script faisant référence à l'objet.
Exemple
    var imgName = document.images[3].name;
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.

nameProp | NN s.o. IE 5 (Win) DOM s.o.
| Lecture seule
Renvoie le nom de fichier (sans le reste du chemin de l´URL) de l´image courante. Simplifie l´examen du contenu de l´image courante.
Exemple
    if (document.images[3].nameProp == "menuOn.jpg") {
        document.image[3].src = "../images/menuOff.jpg";
    }
Valeur
Nom de fichier et extension sensibles à la casse, sous forme de chaîne.
Par défaut
Aucune.

naturalHeight, naturalWidth | NN 6 IE s.o. DOM s.o.
| Lecture seule
Renvoie la hauteur et la largeur du cadre en pixels, sans mise à l´échelle. Permet aux scripts de trouver les vraies dimensions de l´image d´origine quand des scripts ou des attributs d´éléments incorrects avaient mis l´image à l´échelle.
Exemple
    document.logoImg.height = document.logoImg.naturalHeight;
    document.logoImg.width = document.logoImg.naturalWidth;
Valeur
Nombre entier.
Par défaut
Aucune.

protocol | NN s.o. IE 4(Win)/5(Mac) DOM s.o.
| Lecture seule
Renvoie le composant de protocole de l'adresse URL associée à l'élément. Les versions Windows et Macintosh renvoient les valeurs dans des formats différents. Pour la version Windows, les valeurs sont en langage clair élargi (par exemple File Protocol ou HyperText Transfer Protocol); pour la version Mac, les valeurs ressemblent aux valeurs location.protocol (par exemple file: ou http:). Peu fiable dans IE 4 pour Windows.
Valeur
Chaîne.
Par défaut
Aucune.

prototype | NN s.o. IE 4(Mac) DOM s.o.
| Lecture seule
Renvoie une référence à l'objet Image statique à partir duquel sont créées toutes les instances des objets image. Ce mécanisme est plus souvent utilisé dans les objets en langage JavaScript (reportez-vous au chapitre 12). La légitimité de cette propriété est remise en question par le fait qu'elle n'est disponible que dans Internet Explorer 4 pour Macintosh.
Valeur
Référence d´objet
Par défaut
object Image

src | NN 3 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 img. Le chargement d´une image d´une taille différente dans un élément img existant force l´élément à adopter les dimensions de la nouvelle image, sauf dans les navigateurs suivants: Netscape 3, Netscape 4 et IE 3 pour Macintosh. La lecture de cette propriété renvoie l´URL complète, quelle que ce soit la façon dont le formulaire d´URL a affecté la valeur à l´origine.
Exemple
    document.image[3].src = "../images/menuOff.jpg";
Valeur
Chaîne URL.
Par défaut
Aucune.

start | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
Si vous avez spécifié un clip vidéo à l'aide de l'attribut dynsrc, la propriété start permet de contrôler l´action qui lance la lecture du clip.
Exemple
    document.movieImg.start = "mouseover";
Valeur
Constante sous forme de chaîne: fileopen | mouseover.
Par défaut
fileopen

useMap | NN 6 IE 4 DOM 1
| Lecture/écriture
Fournit l´adresse URL de l'élément map dans le document contenant des zones sensibles et des liens de carte image côté client. La valeur contient le caractère # affecté au nom de la carte dans l'attribut usemap de l'élément img.
Exemple
    document.images[0].useMap = "#altMap";
Valeur
Chaîne commençant par le caractère #, suivi du nom de l'élément map.
Par défaut
Aucune.

vspace |
Voir hspace.

width |
Voir height.

x, y | NN 4 IE s.o. DOM s.o.
| Lecture seule
Fournit les coordonnées horizontale et verticale, en pixels, du coin supérieur gauche de l'image par rapport à la page. Ces propriétés ne sont disponibles que dans Navigator et correspondent aux propriétés offsetLeft et offsetTop de Microsoft Internet Explorer.
Exemple
    var imageFromTop = document.logoImg.y;
Valeur
Nombre entier.
Par défaut
Aucune.

blur() | NN 2 IE 3 DOM 1
Supprime l'activation de l'objet courant, moment auquel l'événement onblur de l'objet se déclenche. Remarque: La plage d'éléments capables d'activation et de fondu (l'événement et la méthode) est limitée dans tous les navigateurs sauf dans les versions les plus récentes de Microsoft Internet Explorer (reportez-vous à l'attribut tabindex dans le chapitre 8). Pour une plus grande fiabilité en ce qui concerne la compatibilité ascendante, appliquez la méthode blur() à des éléments qui sont activables de façon évidente, tels que les éléments input et textarea . L'affectation de l'attribut onfocus="this.blur();" à un élément input texte, par exemple, est une façon grossière mais efficace en matière de compatibilité ascendante de désactiver un champ pour les navigateurs ne fournissant pas de véritable désactivation d'éléments.
Utilisez les méthodes blur() et focus() avec modération sur la même page. Vous pouvez déclencher des boucles d'activation et de fondu infinies par accident si des boîtes de dialogue d'alerte sont impliquées à un moment ou à un autre. De plus, sachez que lorsque vous invoquez la méthode blur() sur un objet, un autre objet (peut-être l'objet window ) reçoit un événement onfocus .
Paramètres
Aucune.
Valeur renvoyée
Aucune.

readyState | NN s.o. IE 4 DOM s.o.
| Lecture seule
Renvoie l'état courant du téléchargement du contenu de l'objet. Si un script (en particulier un script déclenché par un événement utilisateur) peut exécuter certaines actions lors du chargement du document, mais doit en éviter d'autres tant que la page n'est pas complètement chargée, cette propriété fournit des informations intermédiaires sur le processus de chargement. Utilisez sa valeur dans des tests de condition. La valeur de cette propriété change de façon dynamique en fonction du progrès du chargement. Toute modification de la valeur de propriété déclenche un événement onReadyStateChange (l'événement ne remonte pas).
Lors de son introduction dans IE 4, la propriété n'était disponible que pour les objets document , embed , img , link , object , script et style . IE 5 a élargi la prise en charge à tous les objets éléments HTML.
Exemple
    if (document.readyState == "loading") {
        //statements for alternate handling while loading
    }
Valeur
Pour tous les éléments sauf object , une des valeurs suivantes, sous forme de chaîne: uninitialized | loading | loaded | interactive | complete . Certains éléments permettent à l'utilisateur d'interagir avec une partie du contenu. Dans ce cas, la propriété peut renvoyer la valeur interactive jusqu'à ce que le chargement soit terminé. Certains types d'éléments ne renvoient pas toutes les valeurs dans l'ordre pendant le processus de chargement. L'élément object renvoie des valeurs numériques pour ces cinq états. Elles vont de 0 (uninitialized ) à 4 (complete ).
Par défaut
Aucune.