HTMLSelectElement

Instanzeigenschaften

Diese Schnittstelle erbt die Eigenschaften von HTMLElement sowie von Element und Node.

Ein Zeichenfolgenwert, der das autocomplete widerspiegelt und angibt, ob der Wert des Steuerelements vom Browser automatisch vervollständigt werden kann.

Ein boolescher Wert, der das disabled HTML-Attribut widerspiegelt, das angibt, ob das Steuerelement deaktiviert ist. Wenn es deaktiviert ist, akzeptiert es keine Klicks.

Ein HTMLFormElement, das das Formular referenziert, mit dem dieses Element verbunden ist. Wenn das Element nicht mit einem <form> Element verbunden ist, gibt es null zurück.

Eine NodeList von <label> Elementen, die mit dem Element assoziiert sind.

Eine unsigned long Angabe der Anzahl der <option> Elemente in diesem select Element.

Ein boolescher Wert, der das multiple HTML-Attribut widerspiegelt, das angibt, ob mehrere Elemente ausgewählt werden können.

Eine Zeichenfolge, die das name HTML-Attribut widerspiegelt und den Namen dieses Steuerelements enthält, der von Servern und DOM-Suchfunktionen verwendet wird.

Eine HTMLOptionsCollection, die die Menge der <option> (HTMLOptionElement) Elemente repräsentiert, die dieses Element enthält.

Ein boolescher Wert, der das required HTML-Attribut widerspiegelt, das angibt, ob der Benutzer vor dem Absenden des Formulars einen Wert auswählen muss.

Ein long, der den Index des ersten ausgewählten <option> Elements widerspiegelt. Der Wert -1 gibt an, dass kein Element ausgewählt ist.

Eine HTMLCollection, die die Menge der <option> Elemente repräsentiert, die ausgewählt sind.

Ein long, der das size HTML-Attribut widerspiegelt und die Anzahl der sichtbaren Elemente im Steuerelement enthält. Der Standardwert ist 1, es sei denn, multiple ist true, in diesem Fall ist es 4.

Eine Zeichenfolge, die den Typ des Formularsteuerelements repräsentiert. Wenn multiple true ist, gibt es "select-multiple" zurück; andernfalls "select-one".

Eine Zeichenfolge, die eine lokalisierte Nachricht darstellt, die die Validierungseinschränkungen beschreibt, die das Steuerelement nicht erfüllt (falls vorhanden). Dieses Attribut ist der leere String, wenn das Steuerelement kein Kandidat für die Constraint-Validierung ist (willValidate ist false) oder es seine Einschränkungen erfüllt.

Ein ValidityState, der den Gültigkeitsstatus wiedergibt, in dem sich dieses Steuerelement befindet.

Eine Zeichenfolge, die den Wert des Formularsteuerelements widerspiegelt. Gibt die value Eigenschaft des ersten ausgewählten Options-Elements zurück, falls vorhanden, ansonsten die leere Zeichenfolge.

Ein boolescher Wert, der angibt, ob der Button ein Kandidat für die Constraint-Validierung ist. Es ist false, wenn Bedingungen es von der Constraint-Validierung ausschließen.

Instanzmethoden

Diese Schnittstelle erbt die Methoden von HTMLElement sowie von Element und Node.

Fügt ein Element zur Sammlung der option Elemente für dieses select Element hinzu.

Überprüft, ob das Element irgendwelche Einschränkungen hat und ob es diese erfüllt. Wenn das Element seine Einschränkungen nicht erfüllt, löst der Browser ein abbruchfähiges invalid Ereignis an dem Element aus (und gibt false zurück).

Ruft ein Element aus der Optionssammlung für dieses <select> Element ab. Sie können auch auf ein Element zugreifen, indem Sie den Index in eckigen Klammern oder Klammern angeben, ohne diese Methode explizit aufzurufen.

Ruft das Element in der Optionssammlung mit dem angegebenen Namen ab. Der Namensstring kann entweder der id oder dem name Attribut eines Optionsknotens entsprechen. Sie können auch auf ein Element zugreifen, indem Sie den Namen in eckigen Klammern oder Klammern angeben, ohne diese Methode explizit aufzurufen.

Entfernt das Element an dem angegebenen Index aus der Optionssammlung für dieses select Element.

Diese Methode berichtet dem Benutzer über Probleme mit den Einschränkungen des Elements, falls vorhanden. Wenn es Probleme gibt, löst sie ein abbruchfähiges invalid Ereignis an dem Element aus und gibt false zurück; wenn es keine Probleme gibt, gibt sie true zurück.

Setzt die benutzerdefinierte Fehlermeldung für das Auswahl-Element auf die angegebene Nachricht. Verwenden Sie den leeren String, um anzugeben, dass das Element keinen benutzerdefinierten Validierungsfehler hat.

Zeigt den Optionsauswahlpicker.

Ereignisse

Diese Schnittstelle erbt die Ereignisse von HTMLElement sowie von Element und Node.

Hören Sie auf diese Ereignisse mit addEventListener() oder indem Sie einen Ereignis-Listener für die oneventname Eigenschaft dieser Schnittstelle zuweisen:

Wird ausgelöst, wenn der Benutzer eine Option auswählt.

Wird ausgelöst, wenn sich der value eines <input>, <select> oder <textarea> Elements geändert hat.

Beispiel

Informationen über die ausgewählte Option abrufen

Eine bessere Möglichkeit, Änderungen an der Auswahl des Benutzers zu verfolgen, besteht darin, auf das change Ereignis am <select> zu achten. Das wird Ihnen mitteilen, wann sich der Wert ändert, und Sie können dann alles Notwendige aktualisieren. Siehe das bereitgestellte Beispiel in der Dokumentation für das change Ereignis für weitere Details.

Spezifikationen

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Siehe auch

• Das <select> HTML-Element, das diese Schnittstelle implementiert.