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.
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 HTMLalt
, 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é CSSborder
est utilisée à la place. HTMLImageElement.complete
Lecture seule-
Retourne un
Boolean
(booléen) qui esttrue
(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 valeursrc
. 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 HTMLheight
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 HTMLismap
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 HTMLreferrerpolicy
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 HTMLsrc
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 HTMLsizes
(taille). HTMLImageElement.srcset
Expérimental-
Est une
DOMString
(chaîne de caractères) reflétant l'attribut HTMLsrcset
, 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 HTMLusemap
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 HTMLwidth
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
etlong
, qui sont la largeur et la hauteur de la ressource, et crée une instance deHTMLImageElement
, 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 ounull
. - 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
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 Standard # htmlimageelement |
Compatibilité des navigateurs
BCD tables only load in the browser
Voir aussi
L'élément HTML implémentant cette interface : <img>