DieHTMLSelectElement Schnittstelle repräsentiert ein<select> HTML-Element. Diese Elemente teilen auch alle Eigenschaften und Methoden anderer HTML-Elemente über dieHTMLElement Schnittstelle.

Instanzeigenschaften

Diese Schnittstelle erbt die Eigenschaften vonHTMLElement sowie vonElement undNode.

HTMLSelectElement.autocomplete

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

HTMLSelectElement.disabled

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

HTMLSelectElement.formSchreibgeschützt

EinHTMLFormElement, das das Formular referenziert, mit dem dieses Element verbunden ist. Wenn das Element nicht mit einem<form> Element verbunden ist, gibt esnull zurück.

HTMLSelectElement.labelsSchreibgeschützt

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

HTMLSelectElement.length

Eineunsigned long Angabe der Anzahl der<option> Elemente in diesemselect Element.

HTMLSelectElement.multiple

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

HTMLSelectElement.name

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

HTMLSelectElement.optionsSchreibgeschützt

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

HTMLSelectElement.required

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

HTMLSelectElement.selectedIndex

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

HTMLSelectElement.selectedOptionsSchreibgeschützt

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

HTMLSelectElement.size

Einlong, der dassize HTML-Attribut widerspiegelt und die Anzahl der sichtbaren Elemente im Steuerelement enthält. Der Standardwert ist 1, es sei denn,multiple isttrue, in diesem Fall ist es 4.

HTMLSelectElement.typeSchreibgeschützt

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

HTMLSelectElement.validationMessageSchreibgeschützt

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.

HTMLSelectElement.validitySchreibgeschützt

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

HTMLSelectElement.value

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

HTMLSelectElement.willValidateSchreibgeschützt

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

Instanzmethoden

Diese Schnittstelle erbt die Methoden vonHTMLElement sowie vonElement undNode.

HTMLSelectElement.add()

Fügt ein Element zur Sammlung deroption Elemente für diesesselect Element hinzu.

HTMLSelectElement.checkValidity()

Ü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ähigesinvalid Ereignis an dem Element aus (und gibtfalse zurück).

HTMLSelectElement.item()

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.

HTMLSelectElement.namedItem()

Ruft das Element in der Optionssammlung mit dem angegebenen Namen ab. Der Namensstring kann entweder derid oder demname 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.

HTMLSelectElement.remove()

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

HTMLSelectElement.reportValidity()

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

HTMLSelectElement.setCustomValidity()

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

showPicker()

Zeigt den Optionsauswahlpicker.

Ereignisse

Diese Schnittstelle erbt die Ereignisse vonHTMLElement sowie vonElement undNode.

Hören Sie auf diese Ereignisse mitaddEventListener() oder indem Sie einen Ereignis-Listener für dieoneventname Eigenschaft dieser Schnittstelle zuweisen:

change Ereignis

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

input Ereignis

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

Beispiel

Informationen über die ausgewählte Option abrufen

/* assuming we have the following HTML<select id='s'>    <option>First</option>    <option selected>Second</option>    <option>Third</option></select>*/const select = document.getElementById("s");// return the index of the selected optionconsole.log(select.selectedIndex); // 1// return the value of the selected optionconsole.log(select.options[select.selectedIndex].value); // Second

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

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