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.

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.

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.

Fournit l´épaisseur, en pixels, de la bordure entourant un élément. Cette propriété est en lecture seule dans Navigator 4.

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.

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.

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é.

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.

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.

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.

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.

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).

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.

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.

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.

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.

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.

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.

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é.

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.

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.

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.

Identifiant associé à l'objet image en vue de son utilisation dans des instructions de script faisant référence à l'objet.

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.

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.

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.

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.

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.

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.

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.

Voir hspace.

Voir height.

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.

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.

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).