Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

O atributo value de HTML

O atributo value tem um significado específico consoante o elemento: pode indicar o valor de um controlo, dados enviados com um formulário, uma medição, o progresso, o número de um item de lista ou uma representação legível por máquinas. Não é um atributo global.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

value="..."

value não tem o mesmo significado em todos os elementos. A sintaxe e o comportamento dependem do elemento e, no caso de input, também de type. No código-fonte HTML, é um atributo de texto, mas um elemento pode interpretar o seu conteúdo como um número ou noutro formato especificado.

Num input de texto, o atributo define o valor predefinido; a propriedade DOM .value expõe o valor atual. Após uma edição pelo utilizador ou uma atribuição a .value, os dois podem ser diferentes. Em checkbox e radio, value define o valor enviado, não se o controlo está selecionado. Em input type="file", o atributo value não deve ser especificado.

Em button, value define o valor enviado com o seu name quando esse botão submete o formulário; o conteúdo do botão fornece a respetiva etiqueta. Em option, define o valor da opção. Se o atributo for omitido, esse valor é obtido a partir do texto da opção.

Em meter, o value obrigatório é uma medição numérica no intervalo min–max (predefinido: 0–1). Em progress, representa o trabalho concluído de 0 a max (predefinido: 1). Se value for omitido, o progresso é indeterminado, não zero. Ambos exigem um número de vírgula flutuante válido em HTML.

Num li de uma lista ol, value é um número inteiro que define o número ordinal do item e a numeração seguinte. Não o utilizes num elemento filho de ul ou menu. Em data, é obrigatório e contém uma representação legível por máquinas do conteúdo visível. O exemplo demonstra a diferença entre o atributo de um input de texto e o seu .value atual.

Exemplos

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

Resultado

Paris
Rome

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes