AREA | NN 3 IE 4 DOM 1
The AREA object reflects the AREA element, which defines the shape, coordinates, and destination of a clickable region of a client-side image map. Navigator and Internet Explorer (for compatibility with Navigator) treat an AREA object as a member of the links collection, since an AREA object behaves much like a link, but for a segment of an image.
HTML Equivalent
    <AREA>
Object Model Reference
NN | [window.]document.links[i]
IE | [window.]document.links[i] [window.]document.all.elementID

alt | NN n/a IE 4 DOM 1
| Read/Write
Future nongraphical browsers may use the alt property setting to display a brief description of the meaning of the (invisible) image's hotspots.
Example
    document.all.elementID.alt = "To Next Page"
Value Any quoted string of characters.
Default | None.

coords | NN n/a IE 4 DOM 1
| Read/Write
Defines the outline of the area to be associated with a particular link or scripted action. Coordinate values are entered as a comma-delimited list. If hotspots of two areas should overlap, the area that is defined earlier in the code takes precedence.
Example
    document.all.mapArea2.coords = "25, 5, 50, 70"
Value Each coordinate is a length value, but the number of coordinates and their order depend on the shape specified by the SHAPE attribute, which may optionally be associated with the element. For SHAPE="rect", there are four coordinates (left, top, right, bottom); for SHAPE="circle" there are three coordinates (center-x, center-y, radius); for SHAPE="poly" there are two coordinate values for each point that defines the shape of the polygon.
Default | None.

hash | NN 2 IE 3 DOM 1
| Read/Write
That portion of the HREF attribute's URL following the # symbol, referring to an anchor location in a document. Do not include the # symbol when setting the property.
Example
    document.all.mapArea2.hash = "section3"
Value String.
Default | None.

host | NN 2 IE 3 DOM 1
| Read/Write
The combination of the hostname and port (if any) of the server of the destination document for the area link. If the port is explicitly part of the URL, the hostname and port are separated by a colon, just as they are in the URL. If the port number is not specified in an HTTP URL for IE 4, it automatically returns the default, port 80.
Example
    document.all.mapArea2.host = "www.megacorp.com:80"
Value String of hostname optionally followed by a colon and port number.
Default | Depends on server.

hostname | NN 2 IE 3 DOM 1
| Read/Write
The hostname of the server (i.e., a "two-dot" address consisting of server name and domain) of the destination document for the area link. The hostname property does not include the port number.
Example
    document.links[2].hostname = "www.megacorp.com"
Value String of hostname (server and domain).
Default | Depends on server.

href | NN 2 IE 3 DOM 1
| Read/Write
The URL specified by the element's HREF attribute.
Example
    document.links[2].href = "http://www.megacorp.com"
Value String of complete or relative URL.
Default | None.

noHref | NN n/a IE 4 DOM 1
| Read/Write
Whether the area defined by the coordinates has a link associated with it. When you set this property to true, scriptable browsers no longer treat the element as a link.
Example
    document.links[4].noHref = "true"
Value Boolean value: true | false.
Default | false

pathname | NN 2 IE 3 DOM 1
| Read/Write
The pathname component of the URL assigned to the element's HREF attribute. This consists of all URL information following the last character of the domain name, including the initial forward slash symbol.
Example
    document.all.myLink.pathname = "/images/logoHiRes.gif"
Value String.
Default | None.

port | NN 2 IE 3 DOM 1
| Read/Write
The port component of the URL assigned to the element's HREF attribute. This consists of all URL information following the colon after the last character of the domain name. The colon is not part of the port property value.
Example
    document.all.myLink.port = "80"
Value String (a numeric value as string).
Default | None.

protocol | NN 2 IE 3 DOM 1
| Read/Write
The protocol component of the URL assigned to the element's HREF attribute. This consists of all URL information up to and including the first colon of a URL. Typical values are: "http:", "file:", "ftp:", "mailto:".
Example
    document.all.secureLink.protocol = "https"
Value String.
Default | None.

search | NN 2 IE 3 DOM 1
| Read/Write
The URL-encoded portion of a URL assigned to the HREF attribute that begins with the ? symbol. A document that is served up as the result of the search also may have the search portion available as part of the window.location property. You can modify this property with a script. Doing so sends the URL and search criteria to the server. You must know the format of data (usually name/value pairs) expected by the server to perform this properly.
Example
    document.all.searchLink.search="?p=Tony+Blair&d=y&g=0&s=a&w=s&m=25"
Value String starting with the ? symbol.
Default | None.

shape | NN n/a IE 4 DOM 1
| Read/Write
The shape of a server-side image map area whose coordinates are specified with the COORDS attribute.
Example
    document.all.area51.shape = "circle"
Value Case-insensitive shape constant as string: default | rect | rectangle | circle | poly | polygon
Default | rect

tabIndex | NN n/a IE 4 DOM 1
| Read/Write
A number that indicates the sequence of this element within the tabbing order of all focusable elements in the document. Tabbing order follows a strict set of rules. Elements that have values other than zero assigned to their tabIndex properties are first in line when a user starts tabbing in a page. Focus starts with the element with the lowest tabIndex value and proceeds in order to the highest value, regardless of physical location on the page or in the document. If two elements have the same tabIndex values, the element that comes earlier in the document receives focus first. Next come all elements that either don't support the tabIndex property or have the value set to zero. These elements receive focus in the order in which they appear in the document. A value of -1 removes the element from tabbing order altogether. Note that the Macintosh user interface does not provide for giving focus to elements other than text and password INPUT fields.
Example
    document.all.mapArea2.tabIndex = 6
Value Integer.
Default | None.

target | NN 2 IE 3 DOM 1
| Read/Write
The name of the window or frame that is to receive content as the result of navigating to an area link. Such names are assigned to frames by the FRAME element's NAME attribute; for subwindows, the name is assigned via the second parameter of the window.open( ) method. If you are scripting the navigation of another window or frame, use the window or frame name in a statement that assigns a new URL to the location.href property (frameName.location.href = "newURL").
Example
    document.all.homeArea.target = "_top"
Value String value of the window or frame name, or any of the following constants (as a string): _parent | _self | _top | _blank. The _parent value targets the frameset to which the current document belongs; the _self value targets the current window; the _top value targets the main browser window, thereby eliminating all frames; and the _blank value creates a new window of default size.
Default | None.

blur( ) | NN n/a IE 4 DOM n/a
Removes focus from the current element and fires an onBlur event (in IE). No other element necessarily receives focus as a result.
Returned Value None.
Parameters None.

focus( ) | NN n/a IE 4 DOM n/a
Gives focus to the current element and fires the onFocus event (in IE). If another element had focus at the time, it receives an onBlur event.
Returned Value None.
Parameters None.