anchors Collection

Internet Development Index

Retrieves a collection of all a objects that have a name and/or id property. Objects in this collection are in HTML source order.

Syntax

[ collAnchors = ] document.anchors
[ oObject = ] document.anchors(vIndex [, iSubIndex])

Possible Values

collAnchorsArray of a objects.
oObjectReference to an individual item in the array of elements contained by the object.
vIndexRequired. Integer or string that specifies the element or collection to retrieve. If this parameter is an integer, the method returns the element in the collection at the given position, where the first element has value 0, the second has 1, and so on. If this parameter is a string and there is more than one element with the name or id property equal to the string, the method returns a collection of matching elements.
iSubIndexOptional. Position of an element to retrieve. This parameter is used when vIndex is a string. The method uses the string to construct a collection of all elements that have a name or id property equal to the string, and then retrieves from this collection the element at the position specified by iSubIndex.

Members Table

PropertyDescription
length Sets or retrieves the number of objects in a collection.
MethodDescription
item Retrieves an object from the all collection or various other collections.
namedItem   Retrieves an object or a collection from the specified collection.
tags Retrieves a collection of objects that have the specified HTML tag name.
urns Retrieves a collection of all objects to which a specified behavior is attached.

Example

This example shows how to display the name property of the third anchor defined in the document.

alert(document.anchors(2).name);

Standards Information

This collection is defined in World Wide Web Consortium (W3C) Document Object Model (DOM) Level 1 Non-Microsoft link.

Applies To

document