Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

Atrybut value w HTML

Atrybut value ma znaczenie zależne od elementu: określa wartość kontrolki, dane wysyłane z formularzem, pomiar, postęp, numer pozycji albo reprezentację danych czytelną maszynowo. Nie jest atrybutem globalnym.

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

Składnia

value="..."

value nie ma jednego znaczenia dla wszystkich elementów. Jego składnia i działanie zależą od elementu oraz, dla input, od type. To atrybut tekstowy w kodzie HTML, ale element może interpretować jego zawartość jako liczbę lub inny określony format.

Dla tekstowego input atrybut określa wartość domyślną; właściwość DOM .value udostępnia wartość bieżącą. Po edycji przez użytkownika lub przypisaniu do .value mogą się różnić. Dla checkbox i radio value określa wysyłaną wartość, a nie zaznaczenie. Dla input type="file" nie wolno podawać atrybutu value.

Dla button value określa wartość wysyłaną pod jego name, gdy przycisk służy do wysłania formularza; etykietę tworzy zawartość przycisku. Dla option określa wartość opcji, a po pominięciu atrybutu jest ona wyprowadzana z tekstu opcji.

Dla meter wymagany value jest liczbą pomiaru w zakresie min–max (domyślnie 0–1). Dla progress oznacza wykonany postęp od 0 do max (domyślnie 1); brak value oznacza postęp nieokreślony, nie zero. Oba wymagają poprawnej liczby zmiennoprzecinkowej HTML.

Dla li w liście ol value jest liczbą całkowitą ustalającą numer pozycji i dalszy ciąg numeracji; nie należy go używać na dziecku ul lub menu. Dla data jest wymagany i zawiera maszynową reprezentację widocznej treści. Przykład pokazuje różnicę między atrybutem tekstowego input a jego bieżącą .value.

Przykłady

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

Wynik

Paris
Rome

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

Źródła