Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

HTMLOptionElement.value — wartość opcji HTML

Odczytaj lub ustaw wartość pojedynczej opcji HTML. Brak atrybutu `value` oznacza użycie tekstu opcji, ale jawnie ustawiony pusty ciąg jest wartością samą w sobie.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

option.value
option.value = newValue

HTMLOptionElement.value to właściwość do odczytu i zapisu pojedynczego elementu option. Odczyt zwraca ciąg znaków niezależnie od tego, czy opcja jest wybrana. Jeśli atrybut HTML value istnieje, odczyt zwraca jego zawartość, nawet gdy jest nią "". Dopiero przy braku atrybutu wartość pochodzi z tekstu opcji: skrajne białe znaki ASCII są usuwane, a ich wewnętrzne serie zastępowane pojedynczą spacją. Atrybut label nie jest źródłem tej wartości zastępczej.

Przypisanie do option.value tworzy lub aktualizuje atrybut value, nie zmieniając tekstu ani stanu wyboru opcji. option.removeAttribute("value") przywraca odczyt wartości z tekstu. Ustaw jawne value, na przykład "plan-pro", jeśli identyfikator ma pozostać stały mimo zmiany lub tłumaczenia widocznej nazwy.

Dla porównania odczyt select.value zwraca wartość pierwszej wybranej opcji w kolejności drzewa DOM albo "", jeśli żadna nie jest wybrana. Pusty wynik nie dowodzi więc braku wyboru. To interfejs API DOM zdefiniowany w standardzie HTML, a nie część ECMAScript; przykład wymaga środowiska udostępniającego HTML DOM.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>HTMLOptionElement.value example</title>
<script>
  const option = document.createElement("option");
  option.textContent = "  Pro\n  plan  ";
  console.log(JSON.stringify([option.value, option.getAttribute("value")]));

  option.value = "";
  console.log(JSON.stringify([option.value, option.getAttribute("value")]));

  option.value = "plan-pro";
  console.log(JSON.stringify([option.value, option.text]));

  option.removeAttribute("value");
  console.log(JSON.stringify([option.value, option.getAttribute("value")]));
</script>

Wynik

["Pro plan",null]
["",""]
["plan-pro","Pro plan"]
["Pro plan",null]

Zapisz przykład jako plik HTML i otwórz go w przeglądarce. Wynik zobaczysz w konsoli deweloperskiej. `null` oznacza brak atrybutu, a nie pustą wartość: w drugim wierszu atrybut istnieje i zawiera `""`. Elementu nie trzeba dodawać do strony.

Powiązane lekcje

  • JavaScript · Lekcja 43 · Średniozaawansowany · Wersja: 3

Źródła