Firefox Tomorrow

web api instance property

HTMLImageElement: useMap property

View on MDN ↗

The useMap property of the HTMLImageElement interface providing the name of the client-side image map to apply to the image. It reflects the <img> element’s usemap content attribute.

Value

A string containing the hash # symbol followed by the name of the <map> element which defines the image map to apply to the image.

Examples

Using useMap

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, you can dynamically construct images that reference the image map as follows:

const image = new Image();
image.src = "menu-box.png";
image.alt = "";
image.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.

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also