# Image Maps
# Introduction to Image Maps
# Description
An image maps is an image with clickable areas that usually act as hyperlinks.
The image is defined by the <img> (opens new window) tag, and the map is defined by a <map> (opens new window) tag with <area> (opens new window) tags to denote each clickable area. Use the usemap and name attributes to bind the image and the map.
# Basic Example
To create an image map so that each of the shapes in the image below are clickable:
The code would be as follows:
<img src="http://jaced.com/blogpix/2007/trisquarecircle/002.gif" usemap="#shapes">
<map name="shapes">
<area shape="polygon" coords="79,6,5,134,153,134">
<area shape="rectangle" coords="177,6,306,134">
<area shape="circle" coords="397,71,65">
</map>
You should see that the browser recognizes the areas when the cursor becomes a pointer. See a live demo (opens new window) on JSFiddle, or see a demonstration below:
# Syntax
<img usemap="#[map-name]"><map name="[map-name]"></map><area>
# Parameters
| Tag/Attribute | Value |
|---|---|
<img> | Below are the image map-specific attributes to use with <img>. Regular <img> attributes apply. |
usemap | The name of the map with a hash symbol prepended to it. For example, for a map with name="map", the image should have usemap="#map". |
<map> | |
name | The name of the map to identify it. To be used with the image's usemap attribute. |
<area> | Below are <area>-specific attributes. When href is specified, making the <area> a link, <area> also supports all of the attributes of the anchor tag (<a>) except ping. See them at the MDN docs (opens new window). |
alt | The alternate text to display if images are not supported. This is only necessary if href is also set on the <area>. |
coords | The coordinates outlining the selectable area. When shape="polygon", this should be set to a list of "x, y" pairs separated by commas (i.e., shape="polygon" coords="x1, y1, x2, y2, x3, y3, ..."). When shape="rectangle", this should be set to left, top, right, bottom. When shape="circle", this should be set to centerX, centerY, radius. |
href | The URL of the hyperlink, if specified. If it is omitted, then the <area> will not represent a hyperlink. |
shape | The shape of the <area>. Can be set to default to select the entire image (no coords attribute necessary), circle or circ for a circle, rectangle or rect for a rectangle, and polygon or poly for a polygonal area specified by corner points. |