areas

NN 6 IE 4 DOM 1

A collection of all area elements associated with a map element. Notice that individual items of an areas collection are also members of the document-wide links collection (document.linksSQAREBRACKET array). But the members of an areas collection are local to a single map element.

Object Model Reference

document.getElementById("mapElementID").areas

Object-Specific Properties

length

Object-Specific Methods

item( )

namedItem( )

tags( )

urns( )

length	NN 6 IE 4 DOM 1
	Read-only
Returns the number of elements in the collection.

Example

var howMany = document.areas.length;

Value
Integer.

item( )	NN 6 IE 4 DOM 1
item(index[, subindex]) item(index)
Returns a single area object or collection of area objects corresponding to the element matching the index value (or, optionally in IE, the index and subindex values).

Parameters

`index` When the parameter is a zero-based integer, the returned value is a single element corresponding to the specified item in source code order (nested within the current element); when the parameter is a string (IE only), the returned value is a collection of elements whose id properties match that string. `subindex` In IE only, if you specify a string value for the first parameter, you can use the second parameter to specify a zero-based index that retrieves the specified element from the collection whose id properties match the first parameter's string value.

Returned Value
One area object or collection (array) of area objects. If there are no matches to the parameters, the returned value is null.

namedItem( )	NN 6 IE 6 DOM 1
namedItem(IDOrName)
Returns a single area object or collection of area objects corresponding to the element matching the parameter string value.

Parameters

`IDOrName` The string that contains the same value as the desired element's id or name attribute.

Returned Value
One area object or collection (array) of area objects. If there are no matches to the parameters, the returned value is null.

tags( )	NN n/a IE 4 DOM n/a
tags(tagName)
Returns a collection of objects (among all objects nested within the current collection) with tags that match the tagName parameter. Implemented in all IE collections (see the all.tags( ) method), but redundant for collections of the same element type.

urns( )	NN n/a IE 5(Win) DOM n/a
urns(URN)
See the all.urns( ) method.