Baseline Widely available *
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>
.
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.
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.
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 :
src
est vide ou null
.src
est la même que l'URL de la page actuelle de l'utilisateur.<img>
.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 Compatibilité des navigateurs Voir aussi
L'élément HTML implémentant cette interface : <img>
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4