Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLImageElement : propriété naturalWidth

Baseline Widely available

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

La propriété en lecture seule naturalWidth de l'interface HTMLImageElement retourne la largeur intrinsèque (naturelle), corrigée de la densité, de l'image en pixels CSS.

Il s'agit de la largeur de l'image lorsqu'aucune contrainte n'est appliquée : si vous ne spécifiez pas de largeur pour l'image, ou si l'image est placée dans un conteneur qui limite ou définit explicitement la largeur, c'est le nombre de pixels CSS de large que l'image aura.

La propriété correspondante naturalHeight retourne la hauteur naturelle de l'image.

Note : La plupart du temps, la largeur naturelle correspond à la largeur réelle de l'image envoyée par le serveur. Cependant, les navigateurs peuvent modifier une image avant de l'afficher. Par exemple, Chrome réduit la résolution des images sur les appareils d'entrée de gamme (angl.). Dans ce cas, naturalWidth considère la largeur de l'image modifiée par ce type d'intervention du navigateur comme la largeur naturelle, et retourne cette valeur.

Valeur

Un entier indiquant la largeur intrinsèque de l'image, en pixels CSS. Il s'agit de la largeur à laquelle l'image est affichée naturellement lorsqu'aucune contrainte ou valeur spécifique n'est définie pour l'image. Cette largeur naturelle est corrigée en fonction de la densité de pixels de l'appareil sur lequel elle est affichée, contrairement à la valeur de width.

Si la largeur intrinsèque n'est pas disponible — soit parce que l'image ne la spécifie pas, soit parce que les données de l'image ne sont pas accessibles pour obtenir cette information — naturalWidth retourne 0.

Exemples

Voir HTMLImageElement.naturalHeight pour un exemple de code qui affiche une image à la fois dans sa taille naturelle « corrigée de la densité » et dans sa taille rendue, modifiée par le CSS de la page et d'autres facteurs.

Spécifications

Specification
HTML
# dom-img-naturalwidth-dev

Compatibilité des navigateurs