HTMLImageElement.isMap

The HTMLImageElement proeprty isMap is a Boolean value which indicates that the image is to be used by a server-side image map. This may only be used on images located within an <a> element.

Note: For accessibility reasons, you should generally avoid using server-side image maps, as they require the use of a mouse. Use a client-side image map instead.

Syntax

htmlImageElement.isMap = true|false;
let isMap = htmlImageElement.isMap;

Value

A Boolean value which is true if the image is being used for a server-side image map; otherwise, the value is false.

Usage notes

When an image marked as being part of a server-side image map is clicked, the browser constructs the string "?x,y", where x and y indicate the coordinates at which the mouse was clicked as offsets from the top-left corner of the image, specified in CSS pixels.

The browser then fetches that URL from the server and displays or downloads it depending on the value of the download attribute.

Unlike server-side image maps, client-side image maps don't cause the <img> element to adopt interactive content mode.

Specifications

Specification Status Comment
HTML Living Standard
The definition of 'HTMLImageElement.isMap' 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.

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
isMapChrome Full support 1Edge Full support 12Firefox Full support YesIE ? Opera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android ? Safari iOS Full support YesSamsung Internet Android Full support Yes

Legend

Full support
Full support
Compatibility unknown
Compatibility unknown