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
|
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. | |||
Exampledocument.all.elementID.alt = "To Next Page" | |||
Value Any quoted string of characters. | |||
|
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. | |||
Exampledocument.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. | |||
|
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. | |||
Exampledocument.all.mapArea2.hash = "section3" | |||
Value String. | |||
|
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. | |||
Exampledocument.all.mapArea2.host = "www.megacorp.com:80" | |||
Value String of hostname optionally followed by a colon and port number. | |||
|
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. | |||
Exampledocument.links[2].hostname = "www.megacorp.com" | |||
Value String of hostname (server and domain). | |||
|
href | NN 2 IE 3 DOM 1 | ||
Read/Write | |||
The URL specified by the element's HREF attribute. | |||
Exampledocument.links[2].href = "http://www.megacorp.com" | |||
Value String of complete or relative URL. | |||
|
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. | |||
Exampledocument.links[4].noHref = "true" | |||
Value Boolean value: true | 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. | |||
Exampledocument.all.myLink.pathname = "/images/logoHiRes.gif" | |||
Value String. | |||
|
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. | |||
Exampledocument.all.myLink.port = "80" | |||
Value String (a numeric value as string). | |||
|
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:". | |||
Exampledocument.all.secureLink.protocol = "https" | |||
Value String. | |||
|
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. | |||
Exampledocument.all.searchLink.search="?p=Tony+Blair&d=y&g=0&s=a&w=s&m=25" | |||
Value String starting with the ? symbol. | |||
|
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. | |||
Exampledocument.all.area51.shape = "circle" | |||
Value Case-insensitive shape constant as string: default | rect | rectangle | circle | poly | polygon | |||
|
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. | |||
Exampledocument.all.mapArea2.tabIndex = 6 | |||
Value Integer. | |||
|
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"). | |||
Exampledocument.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. | |||
|
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. |