HTMLImageElement: useMap 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 useMap
property on the
HTMLImageElement
interface reflects the value of the
HTML usemap
attribute, which is a string
providing the name of the client-side image map to apply to the image.
Value
A string providing the page-local URL (that is, a URL that begins
with the hash or pound symbol, "#
") of the <map>
element
which defines the image map to apply to the image.
You can learn more about client-side image maps in our learning article Add a hitmap on top of an image.
Usage notes
The string value of useMap
must be a valid anchor for a
<map>
element. In other words, this string should be the value of the
appropriate <map>
's name
attribute with a
pound or hash symbol prepended to it.
Consider a <map>
that looks like this:
<map name="mainmenu-map">
<area
shape="circle"
coords="25, 25, 75"
href="/index.html"
alt="Return to home page" />
<area shape="rect" coords="25, 25, 100, 150" href="/index.html" alt="Shop" />
</map>
Given the image map named mainmenu-map
, the image which uses it should
look something like the following:
<img src="menubox.png" usemap="#mainmenu-map" />
For additional examples (including interactive ones), see the articles about the
<map>
and <area>
elements, as well as the guide to using image maps.
Examples
Try it
Specifications
Specification |
---|
HTML Standard # dom-img-usemap |
Browser compatibility
BCD tables only load in the browser