Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

selected — domyślne zaznaczenie opcji

Atrybut logiczny selected określa domyślne zaznaczenie elementu option. Nie jest wiarygodnym odczytem bieżącego wyboru: w JavaScript właściwość selected opisuje aktualny stan, a defaultSelected odzwierciedla atrybut.

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

Składnia

<option selected>...</option>
<option selected="">...</option>
<option selected="selected">...</option>

selected jest atrybutem logicznym elementu option, określającym jego domyślne zaznaczenie. Umieszcza się go na option, nie na select. Bez multiple element select nie może zawierać więcej niż jednej opcji z tym atrybutem; z multiple można określić kilka domyślnych zaznaczeń.

Zapisy selected, selected="" oraz selected="selected" są równoważne. Zapis selected="false" jest niepoprawny i nadal oznacza obecność atrybutu. Aby usunąć domyślne zaznaczenie, pomiń lub usuń atrybut.

W JavaScript option.defaultSelected odzwierciedla atrybut, natomiast option.selected wskazuje bieżące zaznaczenie. Zmiana wyboru przez użytkownika lub przypisanie do option.selected ustawia wewnętrzną flagę zmiany stanu (dirtiness); odtąd zmiana atrybutu nie steruje bezpośrednio zaznaczeniem tej opcji. Do zmiany bieżącego wyboru używaj option.selected lub select.value.

form.reset() odtwarza zaznaczenia na podstawie aktualnych atrybutów selected, czyści flagi dirtiness i stosuje reguły wyboru elementu select. Brak atrybutu nie gwarantuje braku bieżącego zaznaczenia: zwykła lista rozwijana może automatycznie wybrać pierwszą dostępną opcję.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>selected</title>
<form id="demo">
  <label for="color">Color</label>
  <select id="color" name="color">
    <option value="red">Red</option>
    <option value="blue" selected>Blue</option>
  </select>
</form>
<pre id="output"></pre>
<script>
  const form = document.getElementById('demo');
  const select = document.getElementById('color');
  const blue = select.options[1];
  const lines = [];
  function record() {
    lines.push(`${select.value} ${blue.selected} ${blue.defaultSelected}`);
  }
  record();
  select.value = 'red';
  record();
  form.reset();
  record();
  document.getElementById('output').textContent = lines.join('\n');
</script>

Wynik

blue true true
red false true
blue true true

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

Źródła