Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

HTMLOptionElement.value — hodnota volby v HTML

Přečti nebo nastav hodnotu jedné volby v HTML. Chybí-li atribut `value`, použije se text volby. Výslovně nastavená prázdná hodnota však zůstane prázdná.

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

Syntaxe

option.value
option.value = newValue

HTMLOptionElement.value je vlastnost jednotlivého prvku option, kterou lze číst i nastavovat. Při čtení vrací řetězec bez ohledu na to, zda je volba vybraná. Je-li přítomen atribut HTML value, vlastnost vrátí jeho obsah, i kdyby to byl řetězec "". Pouze pokud atribut chybí, odvodí se hodnota z textu volby: bílé znaky ASCII na začátku a konci se odstraní a každá jejich série uvnitř textu se nahradí jednou mezerou. Atribut label není zdrojem této náhradní hodnoty.

Přiřazením do option.value se vytvoří nebo aktualizuje atribut value, aniž by se změnil text volby nebo to, zda je vybraná. Voláním option.removeAttribute("value") se obnoví odvozování hodnoty z textu. Nastav výslovnou hodnotu, například "plan-pro", pokud má identifikátor zůstat stejný i po změně nebo překladu zobrazeného popisku.

Naproti tomu čtení select.value vrátí hodnotu první vybrané volby v pořadí stromu DOM, nebo "", pokud žádná volba není vybraná. Prázdný výsledek tedy nedokazuje, že není nic vybráno. Toto rozhraní DOM definuje standard HTML, nikoli ECMAScript; příklad vyžaduje prostředí s HTML DOM.

Příklady

<!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>

Výsledek

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

Ulož příklad jako soubor HTML a otevři ho v prohlížeči. Výstup se zobrazí ve vývojářské konzoli. `null` znamená, že atribut chybí, nikoli že je prázdný: na druhém řádku atribut existuje a obsahuje `""`. Prvek není potřeba přidávat na stránku.

Související lekce

  • JavaScript · Lekce 43 · Středně pokročilá · Verze: 3

Zdroje