W3cubDocs

/Web APIs

HTMLAreaElement: alt 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 alt property of the HTMLAreaElement interface specifies the text of the hyperlink, defining the textual label for an image map's link. It reflects the <area> element's alt attribute.

The alt value must be text that, when presented with the alt text of the other <area> hyperlinks within the same <map>, along with the alt text of the <img> itself, provides the user with the same kind of choice as the hyperlink would when used without its text but with its shape applied to the image.

If the <area> is a link (contains an href property), the alt property value should be a non-empty string giving the label for the link that would be appropriate if the image were unavailable. The alt attribute for a link <area> can only be empty if there is another <area> element in the same <map> that points to the same resource and has a non-blank alt attribute.

Value

A string.

Examples

const areaElement = document.getElementById("imageArea");
console.log(areaElement.alt);
areaElement.alt = "A much better link description";

Specifications

Specification
HTML>
# dom-area-alt>

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
alt 1 12 1 ≤12.1 1 18 4 ≤12.1 1 1.0 4.4 1

See also

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLAreaElement/alt