CKTIS / HTML
Atribut HTML value
Atribut value má podle prvku různé významy: může určovat hodnotu ovládacího prvku, odesílaná data formuláře, měření, průběh, číslo položky seznamu nebo strojově čitelnou reprezentaci. Nejde o globální atribut.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
value="..."value nemá u všech prvků stejný význam. Jeho syntaxe a chování závisí na prvku a u input také na type. Ve zdrojovém HTML je to textový atribut, ale prvek může jeho obsah interpretovat jako číslo nebo v jiném určeném formátu.
U textového prvku input atribut určuje výchozí hodnotu; vlastnost DOM .value zpřístupňuje aktuální hodnotu. Po úpravě uživatelem nebo přiřazení do .value se mohou lišit. U checkbox a radio určuje value odesílanou hodnotu, nikoli to, zda je ovládací prvek zaškrtnutý. U input type="file" se atribut value nesmí uvádět.
U button určuje value hodnotu odesílanou pod jeho name, když tlačítko odesílá formulář; popisek tlačítka tvoří jeho obsah. U option určuje hodnotu možnosti. Pokud atribut chybí, odvodí se tato hodnota z textu možnosti.
U meter je povinné value číselná hodnota měření v rozsahu min–max (výchozí rozsah 0–1). U progress vyjadřuje dokončenou práci od 0 do max (výchozí hodnota 1). Pokud value chybí, je průběh neurčitý, nikoli nulový. Oba prvky vyžadují platné číslo s plovoucí desetinnou čárkou ve formátu HTML.
U prvku li v seznamu ol je value celé číslo, které nastavuje pořadové číslo položky i následné číslování. Nepoužívejte ho u prvku li, který je přímým potomkem prvku ul nebo menu. U data je povinné a obsahuje strojově čitelnou reprezentaci viditelného obsahu. Příklad ukazuje rozdíl mezi atributem textového input a jeho aktuální hodnotou .value.
Příklady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Attribute and current value</title>
<label>City <input id="city" value="Paris"></label>
<pre id="result"></pre>
<script>
const city = document.getElementById('city');
city.value = 'Rome';
document.getElementById('result').textContent =
city.getAttribute('value') + '\n' + city.value;
</script>
</html>Výsledek
Paris Rome
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.