AREA XHTML Element

Send Feedback

The AREA element 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.

Note   Windows Mobile-based Smartphones do not support frames.

Using this Element

There are some common properties and collections that apply to all the elements of the document object model, see Common Properties for All DOM 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, events and methods.

Attributes

Attribute Value PPC SP Description
CLASS   Yes Yes  
COORDS Special Yes Yes 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 Yes Yes String that specifies that destination URL or anchor point
ID   Yes Yes  
NoHREF   Yes Yes Specifies that the region has no action, used to exclude areas in an image map.
SHAPE   Yes Yes Specifies the shape of an image map region, possible values are circ, circle, poly, polygon, rect, and rectangle.
  circ Yes Yes  
  circle Yes Yes  
  poly Yes Yes  
  polygon Yes Yes  
  rect Yes Yes  
  rectangle Yes Yes  
STYLE   Yes Yes  
TARGET   Yes Yes  
  _blank Yes Yes  
  _parent Yes Yes  
  _self Yes Yes  
  _top Yes Yes  

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

Pocket PC: Windows Mobile 5.0 and later
Smartphone: Windows Mobile 5.0 and later
OS Versions: Windows CE 5.01 and later

See Also

XHTML Elements

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.