KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

Het HTML-attribuut value

Het attribuut value heeft per element een eigen betekenis: het kan de waarde van een bedieningselement, verzonden formuliergegevens, een meting, voortgang, het nummer van een lijstitem of een machineleesbare weergave aangeven. Het is geen globaal attribuut.

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

Syntax

value="..."

value heeft niet voor alle elementen dezelfde betekenis. De syntaxis en werking hangen af van het element en, bij input, ook van type. In HTML-broncode is het een tekstattribuut, maar een element kan de inhoud interpreteren als een getal of in een ander opgegeven formaat.

Bij een tekst-input stelt het attribuut de standaardwaarde in; de DOM-eigenschap .value geeft de huidige waarde weer. Na bewerking door de gebruiker of toewijzing aan .value kunnen die waarden verschillen. Bij checkbox en radio bepaalt value de verzonden waarde, niet of het bedieningselement is aangevinkt. Bij input type="file" mag het attribuut value niet worden opgegeven.

Bij button bepaalt value de waarde die onder de bijbehorende name wordt verzonden wanneer die knop het formulier verzendt; de inhoud van de knop vormt het label. Bij option geeft het de waarde van de optie aan. Als het attribuut ontbreekt, wordt die waarde afgeleid van de optietekst.

Bij meter is de verplichte value een numerieke meting binnen min–max (standaard 0–1). Bij progress staat deze voor voltooid werk van 0 tot max (standaard 1). Als value ontbreekt, is de voortgang onbepaald, niet nul. Beide vereisen een geldig HTML-getal met drijvende komma.

Bij een li in een ol-lijst is value een geheel getal dat het volgnummer van het item en de daaropvolgende nummering instelt. Gebruik het niet bij een kind van ul of menu. Bij data is het verplicht en bevat het een machineleesbare weergave van de zichtbare inhoud. Het voorbeeld laat het verschil zien tussen het attribuut van een tekst-input en de huidige .value.

Voorbeelden

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

Resultaat

Paris
Rome

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen