The height
property of the HTMLImageElement
interface indicates the height at which the image is drawn, in CSS pixels if the image is being drawn or rendered to any visual medium such as the screen or a printer; otherwise, it's the natural, pixel density corrected height of the image.
Syntax
htmlImageElement.height = newHeight; let height = htmlImageElement.height;
Value
An integer value indicating the height of the image. The terms in which the height is defined depends on whether the image is being rendered to a visual medium or not.
- If the image is being rendered to a visual medium such as a screen or printer, the height is expressed in CSS pixels.
- Otherwise, the image's height is represented using its natural (intrinsic) height, adjusted for the display density as indicated by
naturalHeight
.
Example
In this example, two different sizes are provided for an image of a clock using the srcset
attribute. One is 200px wide and the other is 400px wide. Further, the sizes
attribute is provided to specify the width at which the image should be drawn given the viewport's width.
HTML
Specifically, for viewports up to 400px wide, the image is drawn at a width of 200px; otherwise, it's drawn at 300px.
<p>Image height: <span class="size">?</span>px (resize to update)</p>
<img src="/files/17373/clock-demo-200px.png"
alt="Clock"
srcset="/files/17373/clock-demo-200px.png 200w,
/files/17374/clock-demo-400px.png 400w"
sizes="(max-width: 400px) 200px, 300px">
JavaScript
The JavaScript code looks at the height
to determine the height of the image given the width at which it's currently drawn.
var clockImage = document.querySelector("img");
let output = document.querySelector(".size");
const updateHeight = event => { output.innerText = clockImage.height; };
window.addEventListener("load", updateHeight);
window.addEventListener("resize", updateHeight);
Result
This example may be easier to try out [[../../../../../../../mdn.mozillademos.org/en-US/docs/Web/API/HTMLImageElement/height%24samples/Example|in its own window]].
Specifications
Specification | Status | Comment |
---|---|---|
HTML Living StandardThe definition of 'HTMLImageElement.height' in that specification. | Living Standard |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
height
|
Chrome
Full support 1 |
Edge
Full support 12 |
Firefox
Full support Yes |
IE
? |
Opera
Full support Yes |
Safari
Full support Yes |
WebView Android
Full support Yes |
Chrome Android
Full support Yes |
Firefox Android
Full support Yes |
Opera Android
? |
Safari iOS
Full support Yes |
Samsung Internet Android
Full support Yes |
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown
HTMLImageElement.height by Mozilla Contributors is licensed under CC-BY-SA 2.5.