Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

El atributo value de HTML

El atributo value tiene un significado distinto según el elemento: puede indicar el valor de un control, los datos enviados con un formulario, una medición, el progreso, el número de un elemento de lista o una representación legible por máquinas. No es un atributo global.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

value="..."

value no tiene el mismo significado en todos los elementos. Su sintaxis y comportamiento dependen del elemento y, en el caso de input, también de type. En el código fuente HTML es un atributo de texto, pero un elemento puede interpretar su contenido como un número o con otro formato especificado.

En un input de texto, el atributo establece el valor predeterminado; la propiedad DOM .value expone el valor actual. Después de que el usuario lo edite o de asignar un valor a .value, ambos pueden diferir. En checkbox y radio, value determina el valor enviado, no si el control está marcado. En input type="file", no se debe especificar el atributo value.

En button, value especifica el valor enviado bajo su name cuando ese botón envía el formulario; el contenido del botón proporciona su etiqueta. En option, especifica el valor de la opción. Si se omite el atributo, ese valor se obtiene del texto de la opción.

En meter, el value obligatorio es una medición numérica dentro del intervalo min–max (por defecto, 0–1). En progress, representa el trabajo completado desde 0 hasta max (por defecto, 1). Si se omite value, el progreso es indeterminado, no cero. Ambos requieren un número de coma flotante válido según HTML.

En un li de una lista ol, value es un entero que establece el número ordinal del elemento y la numeración posterior. No lo uses en un hijo de ul o menu. En data, es obligatorio y contiene una representación legible por máquinas del contenido visible. El ejemplo muestra la diferencia entre el atributo de un input de texto y su .value actual.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes