Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

The AREAelement defines the shape, coordinates, and associated URL of one hyperlink region within a client-side image map. This element is not rendered and requires a closing tag.

Using this Element

There are some common properties and collections that apply to all the elements of the document object model, see Common Properties, Methods and Collections for the HTML Elements in Internet Explorer Mobile.

This element can be used within a web page with attributes.

This element can be used within scripts where it will have properties, eventsand methods.

Attributes

The following table shows items that Internet Explorer Mobile supports.

Attribute Value Description

CLASS

 

 

COORDS

Special

Specifies the coordinates of the hyperlink area within an image MAP. The format of the string depends on the SHAPE specified.

SHAPE= "circ" or "circle" COORDS= "x1,y1,r" - Where x1,y2 are the coordinates of the center of the circle, and r is the radius of the circle.

SHAPE= "poly" or "polygon" COORDS= "x1,y1,x2,y2...xn,yn" - Where each x,y pair contains the coordinates of one vertex of the polygon.

SHAPE= "rect" (default) or "rectangle" COORDS= "x1,y1,x2,y2" - Where x1,y1 are the coordinates of the upper-left corner of the rectangle and x2,y2 are the coordinates of the lower-right coordinates of the rectangle.

Note:
Percentage values for SHAPE COORDS are not supported. If two or more regions overlap, the region defined first in the map definition takes precedence over subsequent regions. This means that AREA elements with NoHREF should generally be placed before ones with the HREF attribute.

HREF

URL

String that specifies that destination URL or anchor point

ID

 

 

NoHREF

 

Specifies that the region has no action, used to exclude areas in an image map.

SHAPE

 

Specifies the shape of an image map region, possible values are circ, circle, poly, polygon, rect, and rectangle.

 

circ

 

 

circle

 

 

poly

 

 

polygon

 

 

rect

 

 

rectangle

 

STYLE

 

 

TARGET

 

 

 

_blank

 

 

_parent

Causes the immediate parent of the frame to navigate to the HREF.

 

_self

 

 

_top

Causes the browser to navigate the “topmost” document to the HREF.

Scripting Properties

This element has no scripting properties.

Scripting Events

This element has no associated events.

Scripting Methods

This property has no associated methods.

Requirements

Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also