HTMLImageElement
================

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` (en-US) 
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` (en-US)

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` (en-US) 
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` (en-US) Lecture seule 

Retourne un `Boolean` (en-US) *(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` (en-US) .

`HTMLImageElement.crossOrigin` (en-US)

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` (en-US) 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` (en-US)

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` (en-US) 
Obsolète

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

`HTMLImageElement.isMap` (en-US)

Est un `Boolean` (en-US) *(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` (en-US) 
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` (en-US) 
Obsolète

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

`HTMLImageElement.naturalHeight` (en-US) 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` (en-US) 
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` (en-US)

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` (en-US) 
Expérimental

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

`HTMLImageElement.srcset` (en-US) 
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` (en-US)

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` (en-US) 
Obsolète

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

`HTMLImageElement.width` (en-US)

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

`HTMLImageElement.x` (en-US) 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` (en-US) 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 Standard # htmlimageelement |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

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