areasNN 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( )
lengthNN 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