HTMLSelectElement

Instanzeigenschaften

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

HTMLSelectElement.autocomplete

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

HTMLSelectElement.disabled

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

HTMLSelectElement.form Schreibgeschtzt

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 zurck.

HTMLSelectElement.labels Schreibgeschtzt

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

HTMLSelectElement.length

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

HTMLSelectElement.multiple

Ein boolescher Wert, der das multiple HTML-Attribut widerspiegelt, das angibt, ob mehrere Elemente ausgewhlt werden knnen.

HTMLSelectElement.name

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

HTMLSelectElement.options Schreibgeschtzt

Eine HTMLOptionsCollection, die die Menge der <option> (HTMLOptionElement) Elemente reprsentiert, die dieses Element enthlt.

HTMLSelectElement.required

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

HTMLSelectElement.selectedIndex

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

HTMLSelectElement.selectedOptions Schreibgeschtzt

Eine HTMLCollection, die die Menge der <option> Elemente reprsentiert, die ausgewhlt sind.

HTMLSelectElement.size

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

HTMLSelectElement.type Schreibgeschtzt

Eine Zeichenfolge, die den Typ des Formularsteuerelements reprsentiert. Wenn multiple true ist, gibt es "select-multiple" zurck; andernfalls "select-one".

HTMLSelectElement.validationMessage Schreibgeschtzt

Eine Zeichenfolge, die eine lokalisierte Nachricht darstellt, die die Validierungseinschrnkungen beschreibt, die das Steuerelement nicht erfllt (falls vorhanden). Dieses Attribut ist der leere String, wenn das Steuerelement kein Kandidat fr die Constraint-Validierung ist (willValidate ist false) oder es seine Einschrnkungen erfllt.

HTMLSelectElement.validity Schreibgeschtzt

Ein ValidityState, der den Gltigkeitsstatus wiedergibt, in dem sich dieses Steuerelement befindet.

HTMLSelectElement.value

Eine Zeichenfolge, die den Wert des Formularsteuerelements widerspiegelt. Gibt die value Eigenschaft des ersten ausgewhlten Options-Elements zurck, falls vorhanden, ansonsten die leere Zeichenfolge.

HTMLSelectElement.willValidate Schreibgeschtzt

Ein boolescher Wert, der angibt, ob der Button ein Kandidat fr die Constraint-Validierung ist. Es ist false, wenn Bedingungen es von der Constraint-Validierung ausschlieen.

Instanzmethoden

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

HTMLSelectElement.add()

Fgt ein Element zur Sammlung der option Elemente fr dieses select Element hinzu.

HTMLSelectElement.checkValidity()

berprft, ob das Element irgendwelche Einschrnkungen hat und ob es diese erfllt. Wenn das Element seine Einschrnkungen nicht erfllt, lst der Browser ein abbruchfhiges invalid Ereignis an dem Element aus (und gibt false zurck).

HTMLSelectElement.item()

Ruft ein Element aus der Optionssammlung fr dieses <select> Element ab. Sie knnen 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 der id oder dem name Attribut eines Optionsknotens entsprechen. Sie knnen 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 fr dieses select Element.

HTMLSelectElement.reportValidity()

Diese Methode berichtet dem Benutzer ber Probleme mit den Einschrnkungen des Elements, falls vorhanden. Wenn es Probleme gibt, lst sie ein abbruchfhiges invalid Ereignis an dem Element aus und gibt false zurck; wenn es keine Probleme gibt, gibt sie true zurck.

HTMLSelectElement.setCustomValidity()

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

showPicker()

Zeigt den Optionsauswahlpicker.

Ereignisse

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

Hren Sie auf diese Ereignisse mit addEventListener() oder indem Sie einen Ereignis-Listener fr die oneventname Eigenschaft dieser Schnittstelle zuweisen:

change Ereignis

Wird ausgelst, wenn der Benutzer eine Option auswhlt.

input Ereignis

Wird ausgelst, wenn sich der value eines <input>, <select> oder <textarea> Elements gendert hat.

Beispiel

Informationen ber die ausgewhlte 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 option
console.log(select.selectedIndex); // 1

// return the value of the selected option
console.log(select.options[select.selectedIndex].value); // Second

Eine bessere Mglichkeit, 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 knnen dann alles Notwendige aktualisieren. Siehe das bereitgestellte Beispiel in der Dokumentation fr das change Ereignis fr weitere Details.

Spezifikationen

Browser-Kompatibilitt

Siehe auch

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