optionsNN 2 IE 3 DOM 1

Ein Array mit option-Elementen, die in einem select-Objekt verschachtelt sind.

 
Objektmodellreferenz
 
[window.]document.formName.selectName.options
[window.]document.forms[i].elements[i].options
[window.]document.getElementById("selectElementID").options
 
Objektspezifische Eigenschaften
 
length
 
Objektspezifische Methoden
 
add( )item( )namedItem( )remove( )tags( )urns( )
lengthNN 2 IE 3 DOM 1

Schreibgeschützt

Gibt die Anzahl von Elementen in der Sammlung zurück.

 
Beispiel
 
var howMany = document.forms[0].mySelect.options.length;
 
Wert

Eine ganze Zahl.

add( )NN nicht zutreffend IE 4 DOM nicht zutreffend

add(elementRef[, index])

Fügt der aktuellen Sammlung ein bereits (mit der createElement( )-Methode) erstelltes Element hinzu. Das Element muss vom Typ option sein. Standardmäßig wird das neue Element als letztes Element in die Sammlung aufgenommen, sofern Sie keinen Indexwert als zweiten Parameter angeben (in welchem Fall alle auf die betreffende Indexposition folgenden Elemente um eine Position nach hinten gerückt werden). Im folgenden Beispiel wird einem select-Objekt ein neues Element hinzugefügt:

var newElem = document.createElement("option");
newElem.text = "Freddy";
newElem.value = "Freddy Mercury";
document.forms[1].rockers.options.add(newElem);
 

Beachten Sie, dass zunächst ein generisches Objekt erstellt wird. Anschließend werden seine Eigenschaften mit Werten aufgefüllt, und das neue Element wird dem selected-Element hinzugefügt.

 

Ein Beispiel für einen browserübergreifenden und rückwärtskompatiblen Ansatz zur Durchführung dieser Aufgabe finden Sie in der Beschreibung des option-Objekts. Unter der Methode select.add( ) finden Sie ein entsprechendes W3C-DOM-Verfahren, das in Netscape 6 angewendet werden kann.

 
Parameter
 
  • Eine vollständige Elementobjektreferenz, die normalerweise von der createElement( )-Methode erstellt wird.
  • Eine optionale ganze Zahl, die die Position in der Objektsammlung angibt, an der das neue Element platziert werden soll.
 
Zurückgegebener Wert

Keiner.

item( )NN 6 IE 4 DOM 1

item(index[, subindex]) item(index)

Gibt ein einzelnes Objekt oder eine Objektsammlung zurück, das bzw. die dem mit dem Indexwert (oder optional mit dem Index- und dem Subindexwert) ü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, das dem angegebenen Element in der Quellcodereihenfolge (verschachtelt im aktuellen Element) entspricht; handelt es sich bei dem Parameter eine Zeichenfolge, ist der zurückgegebene Wert eine Sammlung der Elemente, deren id-Eigenschaft 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 einer Sammlung abruft, deren id-Eigenschaft mit dem Zeichenfolgenwert des ersten Parameters übereinstimmt.
 
Zurückgegebener Wert

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

namedItem( )NN 6 IE 6 DOM 1

namedItem("ID")

Gibt ein einzelnes option-Objekt zurück, das dem mit dem Wert der Parameterzeichenfolge übereinstimmenden Element entspricht.

 
Parameter
 
  • Die Zeichenfolge, die denselben Wert wie das id-Attribut des gewünschten Elements enthält.
 
Zurückgegebener Wert

Ein option-Objekt. Falls keine Übereinstimmung mit den Parametern vorliegt, lautet der zurückgegebene Wert null.

remove( )NN nicht zutreffend IE 4 DOM nicht zutreffend

remove(index)

Löscht ein Element aus der aktuellen Sammlung. Sie müssen lediglich den auf Null basierenden Indexwert des option-Elements angeben, das Sie aus der Sammlung eines select-Elements entfernen möchten. Im folgenden Beispiel wird das erste Element aus einem select-Objekt gelöscht:

document.forms[1].rockers.options.remove(0);
 

In Navigator unterscheidet sich der Vorgang zum Entfernen eines option-Elements vollständig von dieser Vorgehensweise. Zum Löschen eines Elements weisen Sie diesem in der Sammlung null zu. Die Navigator-Version des obigen IE-Beispiels sieht z. B. wie folgt aus:

document.forms[1].rockers.options[0] = null;
 

Unabhängig von der browserspezifischen Vorgehensweise zum Entfernen einer Option aus dem select-Objekt wird die Länge des options-Arrays reduziert, um den Platz zu füllen.

 
Parameter
 
  • Eine auf Null basierende ganze Zahl, die angibt, welches Element in der Sammlung gelöscht werden soll.
 
Zurückgegebener Wert

Keiner.

tags( )NN nicht zutreffend IE 4 DOM nicht zutreffend

tags("tagName")

Gibt eine Sammlung von Objekten zurück (aus allen in der aktuellen Sammlung 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