HTMLImageElement: height property
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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.
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
.
Examples
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="/en-US/docs/Web/HTML/Element/img/clock-demo-200px.png"
alt="Clock"
srcset="
/en-US/docs/Web/HTML/Element/img/clock-demo-200px.png 200w,
/en-US/docs/Web/HTML/Element/img/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.
const 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 in its own window.
Specifications
Specification |
---|
HTML Standard # dom-img-height-dev |
Browser compatibility
BCD tables only load in the browser