Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

L’attribut HTML value

L’attribut value a un sens propre à chaque élément : valeur d’un contrôle, données de formulaire envoyées, mesure, progression, numéro d’un élément de liste ou représentation lisible par une machine. Ce n’est pas un attribut global.

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

Syntaxe

value="..."

value n’a pas le même sens pour tous les éléments. Sa syntaxe et son comportement dépendent de l’élément et, pour input, de type. Dans le code source HTML, c’est un attribut textuel, mais un élément peut interpréter son contenu comme un nombre ou selon un autre format défini.

Pour un input de type texte, l’attribut définit la valeur par défaut ; la propriété DOM .value expose la valeur actuelle. Après une modification par l’utilisateur ou une affectation à .value, les deux peuvent différer. Pour checkbox et radio, value définit la valeur envoyée, pas l’état coché du contrôle. Pour input type="file", l’attribut value ne doit pas être indiqué.

Pour button, value définit la valeur envoyée sous son name lorsque ce bouton soumet le formulaire ; le contenu du bouton fournit son libellé. Pour option, il définit la valeur de l’option. Si l’attribut est omis, cette valeur est déduite du texte de l’option.

Pour meter, le value obligatoire est une mesure numérique comprise entre min et max (par défaut, 0–1). Pour progress, il représente le travail accompli, de 0 à max (par défaut, 1). En l’absence de value, la progression est indéterminée, et non égale à zéro. Les deux exigent un nombre à virgule flottante valide au format HTML.

Pour un li dans une liste ol, value est un entier qui fixe le numéro ordinal de l’élément et la numérotation suivante. Ne l’utilisez pas sur un enfant de ul ou de menu. Pour data, il est obligatoire et contient une représentation lisible par une machine du contenu visible. L’exemple montre la différence entre l’attribut d’un input de type texte et son .value actuel.

Exemples

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

Résultat

Paris
Rome

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources