HTMLImageElement: alt property

{{APIRef("HTML DOM")}} 

The alt property of the {{domxref("HTMLImageElement")}}  interface provides fallback (alternate) text to display when the image specified by the {{HTMLElement("img")}}  element is not displayed, whether because of an error, because the user has disabled the loading of images, or because the image hasn’t finished loading yet. It reflects the <img> element’s alt content attribute.

There are important accessibility implications of providing appropriate alt text, and the requirements may differ based on the purpose of the image. See the HTML <img> reference for more information.

Value

A string.

Examples

Setting the alt attribute

const img = new Image();
img.src = "example.png";
img.alt = "An example picture";

Specifications

{{Specifications}} 

Browser compatibility

{{Compat}}