Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

HTMLSelectElement.value — wartość zaznaczonej opcji

HTMLSelectElement.value odczytuje wartość pierwszej zaznaczonej opcji lub zmienia zaznaczenie przez dopasowanie wartości.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

select.value
select.value = "value"

HTMLSelectElement.value zwraca ciąg znaków: wartość pierwszej zaznaczonej opcji w kolejności drzewa albo "", gdy żadna nie jest zaznaczona. Wartość opcji pochodzi z atrybutu value, a przy jego braku — z tekstu opcji.

Przypisanie zaznacza tylko pierwszą pasującą opcję i odznacza pozostałe, także przy multiple. Brak dopasowania usuwa zaznaczenie: value wynosi "", a selectedIndex wynosi -1.

Przy multiple odczyt nadal zwraca jedną wartość, nie tablicę; wszystkie zaznaczone opcje udostępnia selectedOptions. Samo "" nie odróżnia braku zaznaczenia od zaznaczonej opcji o pustej wartości.

Przykłady

const select = document.createElement("select");
select.add(new Option("Alpha", "a"));
select.add(new Option("Beta", "b"));

select.value = "b";
console.log(JSON.stringify(select.value));

select.value = "missing";
console.log(JSON.stringify(select.value));
console.log(select.selectedIndex);

Wynik

"b"
""
-1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła