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 StandardThe 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.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
isMap
|
Chrome
Full support 1 |
Edge
Full support 12 |
Firefox
Full support Yes |
IE
? |
Opera
Full support Yes |
Safari
Full support Yes |
WebView Android
Full support Yes |
Chrome Android
Full support Yes |
Firefox Android
Full support Yes |
Opera Android
? |
Safari iOS
Full support Yes |
Samsung Internet Android
Full support Yes |
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown
HTMLImageElement.isMap by Mozilla Contributors is licensed under CC-BY-SA 2.5.