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
Loading…