Baseline Widely available *
Die HTMLSelectElement
Schnittstelle repräsentiert ein <select>
HTML-Element. Diese Elemente teilen auch alle Eigenschaften und Methoden anderer HTML-Elemente über die HTMLElement
Schnittstelle.
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 vervollständigt 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
Schreibgeschützt
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.
HTMLSelectElement.labels
Schreibgeschützt
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 ausgewählt werden können.
HTMLSelectElement.name
Eine Zeichenfolge, die das name
HTML-Attribut widerspiegelt und den Namen dieses Steuerelements enthält, der von Servern und DOM-Suchfunktionen verwendet wird.
HTMLSelectElement.options
Schreibgeschützt
Eine HTMLOptionsCollection
, die die Menge der <option>
(HTMLOptionElement
) Elemente repräsentiert, die dieses Element enthält.
HTMLSelectElement.required
Ein boolescher Wert, der das required
HTML-Attribut widerspiegelt, das angibt, ob der Benutzer vor dem Absenden des Formulars einen Wert auswählen muss.
HTMLSelectElement.selectedIndex
Ein long
, der den Index des ersten ausgewählten <option>
Elements widerspiegelt. Der Wert -1
gibt an, dass kein Element ausgewählt ist.
HTMLSelectElement.selectedOptions
Schreibgeschützt
Eine HTMLCollection
, die die Menge der <option>
Elemente repräsentiert, die ausgewählt sind.
HTMLSelectElement.size
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.
HTMLSelectElement.type
Schreibgeschützt
Eine Zeichenfolge, die den Typ des Formularsteuerelements repräsentiert. Wenn multiple
true
ist, gibt es "select-multiple"
zurück; andernfalls "select-one"
.
HTMLSelectElement.validationMessage
Schreibgeschü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.validity
Schreibgeschützt
Ein ValidityState
, der den Gültigkeitsstatus wiedergibt, in dem sich dieses Steuerelement befindet.
HTMLSelectElement.value
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.
HTMLSelectElement.willValidate
Schreibgeschützt
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.
Diese Schnittstelle erbt die Methoden von HTMLElement
sowie von Element
und Node
.
HTMLSelectElement.add()
Fügt ein Element zur Sammlung der option
Elemente für dieses select
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ähiges invalid
Ereignis an dem Element aus (und gibt false
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 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.
HTMLSelectElement.remove()
Entfernt das Element an dem angegebenen Index aus der Optionssammlung für dieses select
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ähiges invalid
Ereignis an dem Element aus und gibt false
zurück; wenn es keine Probleme gibt, gibt sie true
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 Element keinen benutzerdefinierten Validierungsfehler hat.
showPicker()
Zeigt den Optionsauswahlpicker.
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:
change
Ereignis
Wird ausgelöst, wenn der Benutzer eine Option auswählt.
input
Ereignis
Wird ausgelöst, wenn sich der value
eines <input>
, <select>
oder <textarea>
Elements geändert hat.
/* 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 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.
<select>
HTML-Element, das diese Schnittstelle implementiert.RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4