areas

NN 6 IE 4 DOM 1

Eine Sammlung aller area-Elemente, die mit einem map-Element verknüpft sind. Beachten Sie, dass einzelne Elemente einer area-Sammlung gleichzeitig auch in der dokumentweiten links-Sammlung (document.links[ ]-Array) enthalten sind. Die in einer areas-Sammlung enthaltenen Objekte gehören jedoch lokal zu einem einzelnen map-Element.

Objektmodellreferenz

document.getElementById("mapElementID").areas

Objektspezifische Eigenschaften

length

Objektspezifische Methoden

item( )

namedItem( )

tags( )

urns( )

length	NN 6 IE 4 DOM 1
	Schreibgeschützt
Gibt die Anzahl von Elementen in der Sammlung zurück.

Beispiel

var howMany = document.areas.length;

Wert
Eine ganze Zahl.

item( )	NN 6 IE 4 DOM 1
item(index[, subindex]) item(index)
Gibt ein einzelnes area-Objekt oder eine area-Sammlung zurück, das bzw. die dem mit dem Indexwert (oder bei IE optional mit dem index- und dem subindex-Wert) übereinstimmenden Element entspricht.

Parameter

Handelt es sich bei dem Parameter um eine auf Null basierende ganze Zahl, ist der zurückgegebene Wert ein einzelnes Element entsprechend des angegebenen Elements in der Quellcodereihenfolge (verschachtelt im aktuellen Element); handelt es sich bei dem Parameter eine Zeichenfolge, ist der zurückgegebene Wert eine Sammlung der Elemente, deren Eigenschaft id oder name mit der Zeichenfolge übereinstimmt. Wenn Sie eine Zeichenfolge als ersten Parameter angeben (nur IE), können Sie den zweiten Parameter verwenden, um einen auf Null basierenden Index anzugeben, der das angegebene Element aus der Sammlung abruft, dessen id- oder name-Eigenschaft mit der Zeichenfolge des ersten Parameters übereinstimmt.

Zurückgegebener Wert
Ein area-Objekt oder eine area-Objektsammlung (Array). Falls keine Übereinstimmung mit den Parametern vorliegt, lautet der zurückgegebene Wert null.

namedItem( )	NN 6 IE 6 DOM 1
namedItem(IDOrName)
Gibt ein einzelnes area-Objekt oder eine area-Objektsammlung zurück, das bzw. die dem mit dem Wert der Parameterzeichenfolge übereinstimmenden Element entspricht.

Parameter

Die Zeichenfolge, die denselben Wert wie das id- oder name-Attribut des gewünschten Elements enthält.

Zurückgegebener Wert
Ein area-Objekt oder eine area-Objektsammlung (Array). Falls keine Übereinstimmung mit den Parametern vorliegt, lautet der zurückgegebene Wert null.

tags( )	NN nicht zutreffend IE 4 DOM nicht zutreffend
tags(tagName)
Gibt eine Sammlung von Objekten zurück (aus allen in der aktuellen Objektsammlung verschachtelten Objekten), deren Tags mit dem tagName-Parameter übereinstimmen. In allen IE-Sammlungen implementiert (siehe all.tags( )-Methode), für Sammlungen desselben Elementtyps jedoch überflüssig.

urns( )	NN nicht zutreffend IE 5(Win) DOM nicht zutreffend
urns(URN)
Siehe all.urns( )-Methode