HTMLImageElement

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

L'interface HTMLImageElement fournit des propriétés et des méthodes spéciales pour manipuler la mise en page et la présentation des éléments <img> .

Propriétés

Hérite les propriétés de son parent, HTMLElement.

HTMLImageElement.align Obsolète

Est une DOMString (chaîne de caractères) qui indique l'alignement de l'image en respectant le contexte environnant. Les valeurs possibles sont "left"(gauche), "right"(droite), "justify"(justifié), et "center"(centré) .

HTMLImageElement.alt

Est une DOMString (chaîne de caractères) qui reflète les attributs HTML alt , ceux-ci indiquant le recul du contexte de l'image.

HTMLImageElement.border Obsolète

Est une DOMString (chaîne de caractères) qui est responsable de la largeur de la bordure entourant l'image. Il est maintenant déprécié et la propriété CSS border est utilisée à la place.

HTMLImageElement.complete Lecture seule

Retourne un Boolean (booléen) qui est true (vrai) si le navigateur a fini de chercher l'image, que ce soit avec succès ou non. Il affiche aussi "true" si l'image n'a pas de valeur src .

HTMLImageElement.crossOrigin

Est une DOMString (chaîne de caractères) représentant le paramètre CORS défini pour cet élément image. Voir Attributs de règlage du CORS pour plus de détails.

HTMLImageElement.currentSrc Lecture seule Expérimental

Retourne une DOMString (chaîne de caractères) représentant l'URL de l'image courante affichée (qui peut changer, par exemple en réponse à une requête multimédia).

HTMLImageElement.height

Est un unsigned long (non signé long) qui reflète l'attibut HTML height indiquant la hauteur du rendu de l'image en pixels CSS.

HTMLImageElement.hspace Obsolète

Est un long représentant l'espace de chaque côté de l'image.

HTMLImageElement.isMap

Est un Boolean (booléen) qui reflète l'attribut HTML ismap indiquant que l'image fait partie d'une carte d'image côté serveur.

HTMLImageElement.longDesc Obsolète

Est une DOMString (chaîne de caractères) représentant l'URL d'une longue description de l'image.

HTMLImageElement.lowSrc Obsolète

Est une DOMString (chaîne de caractères) qui fait référence à une copie de faible qualité (mais plus rapide à charger) de l'image.

HTMLImageElement.name Obsolète

Est une DOMString (chaîne de caractères) représentant le nom de l'élément.

HTMLImageElement.naturalHeight Lecture seule

Retourne un unsigned long représentant la hauteur intrinsèque de l'image en pixels CSS, si elle est disponible ; sinon, 0 est affiché.

HTMLImageElement.referrerPolicy Expérimental

Est une DOMString (chaîne de caractères) qui reflète l'attribut HTML referrerpolicy indiquant la référence à utiliser pour récupérer l'image.

HTMLImageElement.src

Est une DOMString (chaîne de caractères) qui reflète l'attribut HTML src contenant l'URL complète de l'image y compris l'URI de base.

HTMLImageElement.sizes Expérimental

Est une DOMString (chaîne de caractères) reflétant l'attribut HTML sizes (taille).

HTMLImageElement.srcset Expérimental

Est une DOMString (chaîne de caractères) reflétant l'attribut HTML srcset , qui contient une liste d'images candidates, séparées par une virgule. Une image candidate est une URL suivie d'un 'w' avec la largeur de l'image ou d'un 'x' avec la densité en pixels.

HTMLImageElement.useMap

Est une DOMString (chaîne de caractères) qui reflète l'attribut HTML usemap contenant une URL partielle d'un élément "map" (carte).

HTMLImageElement.vspace Obsolète

Est un long représentant l'espace au-dessus et en-dessous de l'image.

HTMLImageElement.width

Est un unsigned long qui reflète l'attribut HTML width indiquant la largeur rendue de l'image en pixels CSS.

HTMLImageElement.x Lecture seule Expérimental

Retourne un long représentant le décalage horizontal à partir de la couche la plus proche. Cette propriété imite un comportement ancien de Netscape 4.

HTMLImageElement.y Lecture seule Expérimental

Retourne un long représentant le décalage vertical à partir de la couche la plus proche. Cette propriété imite un comportement ancien de Netscape 4.

Méthodes

Hérite les propriétés de son parent, HTMLElement.

Image()

Le constructeur d'image, comprend deux propriétés unsigned et long, qui sont la largeur et la hauteur de la ressource, et crée une instance de HTMLImageElement , non insérée dans une arborescence DOM.

Erreurs

Si une erreur apparaît pendant un essai de chargement ou de rendu de l'image, et si un gestionnaire d'évènements onerror a été configuré pour gérer les évènements error, ce gestionnaire est appelé. Cela peut se produire dans un certain nombre de situations, y compris :

  • L'attribut src est vide ou null.
  • L'URL spécifiée de src est la même que l'URL de la page actuelle de l'utilisateur.
  • L'image spécifiée est corrompue de telle manière qu'elle ne peut être chargée.
  • Les métadonnées de l'image spécifiée sont corrompues empêchant de récupérer ses dimensions, et aucune dimension n'est spécifiée dans les attributs de l'élément <img>.
  • L'image spécifiée est dans un format non supporté par l'"user agent".

Exemple

js
var img1 = new Image(); //  Constructeur HTML5
img1.src = "image1.png";
img1.alt = "alt";
document.body.appendChild(img1);

var img2 = document.createElement("img"); // utilise DOM HTMLImageElement
img2.src = "image2.jpg";
img2.alt = "alt text";
document.body.appendChild(img2);

// en utilisant la première image dans le document
alert(document.images[0].src);

Spécifications

Specification
HTML
# htmlimageelement

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
HTMLImageElement
Image() constructor
align
Deprecated
alt
attributionSrc
Experimental
border
Deprecated
complete
crossOrigin
currentSrc
decode()
decoding
fetchPriority
height
hspace
Deprecated
isMap
loading
longDesc
Deprecated
lowsrc
Deprecated
name
Deprecated
naturalHeight
naturalWidth
referrerPolicy
no-referrer-when-downgrade
origin-when-cross-origin
unsafe-url
sharedStorageWritable
Experimental
sizes
auto value
src
srcset
useMap
vspace
Deprecated
width
x
y

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
Deprecated. Not for use in new websites.
See implementation notes.
Uses a non-standard name.
Has more compatibility info.

Voir aussi

L'élément HTML implémentant cette interface : <img>