HTML <map> id Attribute

The id attribute on a <map> tag assigns an identifier to the image map. The identifier must be unique across the page.

Example

#

An id attribute on a <map> element.

Computer Computer Keyboard Mouse
<img src="/img/html/computer-map.png" alt="Computer" usemap="#computermap">

<map id="computer-map" name="computermap">
  <area shape="rect" coords="253,142,16,2" alt="Computer" href="javascript:alert('Computer screen was clicked');">
  <area shape="rect" coords="262,218,0,156" alt="Keyboard" href="javascript:alert('Computer keyboard was clicked');">
  <area shape="circle" coords="267,234,22" alt="Mouse" href="javascript:alert('Computer mouse was clicked');">
</map>

Using id

The id attribute assigns an identifier to the <map> element.

The identifier must be unique across the page.

The id allows programmatic access to the <map> element.

Tip:  id is a global attribute that can be applied to any HTML element.


Syntax

<map id="identifier" />

Values

#

Value Description
identifier A unique alphanumeric string. The id value must begin with a letter ([A-Za-z]) and may be followed by any number of letters, digits ([0-9]), hyphens (-), underscores (_), colons (:), and periods (.).

More Examples

A <map> tag with a unique id.
Clicking the button displays the name of the map.

Computer Computer Keyboard Mouse
<img src="/img/html/computer-map.png" alt="Computer" usemap="#computermap">
 
<map id="mymap" name="computermap">
  <area shape="rect" coords="253,142,16,2" alt="Computer" href="javascript:alert('Computer screen was clicked');">
  <area shape="rect" coords="262,218,0,156" alt="Keyboard" href="javascript:alert('Computer keyboard was clicked');">
  <area shape="circle" coords="267,234,22" alt="Mouse" href="javascript:alert('Computer mouse was clicked');">
</map>
  
<br />
<button onclick="show();">Show map name</button>

<script>
  let show = () => {
    let element = document.getElementById("mymap");
    alert("Name = " + element.name);
  }
</script>

Code explanation

The id attribute assigns a unique identifier for the <map> element.

Clicking the button calls JavaScript which locates the <map> using the id.

Finally, the name of the <map> is displayed in an alert box.


Browser support

Here is when id support started for each browser:

Chrome
1.0 Sep 2008
Firefox
1.0 Sep 2002
IE/Edge
1.0 Aug 1995
Opera
1.0 Jan 2006
Safari
1.0 Jan 2003

You may also like

 Back to <map>
Guides