HTMLImageElement: width property

{{APIRef("HTML DOM")}}

The width property of the {{domxref("HTMLImageElement")}} interface indicates the width at which the image is drawn, in {{Glossary("CSS pixel", "CSS pixels")}}, if the image is being drawn or rendered to any visual medium such as a screen or printer. Otherwise, it's the natural, pixel density-corrected width of the image.

Value

An integer value indicating the width of the image. The way the width 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 width is expressed in {{Glossary("CSS pixel", "CSS pixels")}}.
• Otherwise, the image's width is represented using its natural (intrinsic) width, adjusted for the display density as indicated by {{domxref("HTMLImageElement.naturalWidth", "naturalWidth")}}.

Examples

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

For viewports up to 400px wide, the image is drawn at a width of 200px. Otherwise, it's drawn at 400px.

<p>Image width: <span class="size">?</span>px (resize to update)</p>

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 updateWidth = () => {
  output.innerText = clockImage.width;
};

updateWidth();
window.addEventListener("resize", updateWidth);

Result

{{EmbedLiveSample("Examples", 640, 450)}}

This example may be easier to try out {{LiveSampleLink('Examples', 'in its own window')}}.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• {{domxref("HTMLImageElement.height")}}
• {{domxref("HTMLImageElement.naturalWidth")}}
• {{domxref("HTMLCanvasElement.width")}}
• {{domxref("HTMLEmbedElement.width")}}
• {{domxref("HTMLIFrameElement.width")}}
• {{domxref("HTMLObjectElement.width")}}
• {{domxref("HTMLSourceElement.width")}}
• {{domxref("HTMLVideoElement.width")}}