Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

select — kontrolka wyboru

Element `select` pozwala wybierać spośród opcji formularza. Poznaj wybór pojedynczy i wielokrotny, etykietę oraz rolę `name` podczas przesyłania danych.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

<select name="field" id="field"><option value="value">Label</option></select>

select udostępnia wybór spośród elementów option. Bez multiple służy do wyboru pojedynczego; z multiple pozwala zaznaczyć zero lub więcej opcji. size określa liczbę widocznych pozycji.

Powiąż label z kontrolką przez zgodne for i id. name jest kluczem w danych formularza, a id identyfikatorem kontrolki, nie kluczem przesyłania. Każda zaznaczona, niewyłączona opcja wnosi swoją wartość; przy multiple klucz może się powtarzać. Kontrolka z disabled jest pomijana.

Dla wymaganego wyboru pojedynczego o rozmiarze wyświetlania 1 pierwsza opcja musi pełnić rolę wskazówki: musi mieć pustą wartość, a jej bezpośrednim rodzicem musi być sam element select, nie optgroup ani żaden inny element. Samo jej zaznaczenie nie spełnia required.

Przykład ma początkowo zaznaczoną opcję dark. Skrypt odczytuje dane formularza bez wysyłania ich do serwera. Wynik przedstawia stan początkowy; nie aktualizuje się po zmianie wyboru.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Select example</title>
<form id="settings">
  <label for="theme">Theme</label>
  <select id="theme" name="theme" required>
    <option value="">Choose a theme</option>
    <option value="light">Light</option>
    <option value="dark" selected>Dark</option>
  </select>
</form>
<pre id="result"></pre>
<script>
  const form = document.getElementById('settings');
  const data = new FormData(form);
  document.getElementById('result').textContent = data.get('theme');
</script>
</html>

Wynik

dark

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

Źródła