HTMLImageElement: useMap property

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("HTML DOM")}}

The **useMap** property of the {{domxref("HTMLImageElement")}} interface provides the name of the client-side image map to apply to the image. It reflects the <img> element's [usemap](/en-US/docs/Web/HTML/Reference/Elements/img#usemap) content attribute.

Value

A string containing the hash # symbol followed by the [name](/en-US/docs/Web/HTML/Reference/Elements/map#name) of the {{HTMLElement("map")}} element which defines the image map to apply to the image.

Examples

Using useMap

Consider a <map> that looks like this:

html
<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:

js
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 {{HTMLElement("map")}} and {{HTMLElement("area")}} elements, as well as the guide to using image maps.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also