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

CKTIS / JavaScript

HTMLOptionElement.value — valor de una opción HTML

Lee o establece el valor de una opción HTML. Si falta el atributo `value`, se usa el texto de la opción; un valor establecido explícitamente como vacío sigue vacío.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

option.value
option.value = newValue

HTMLOptionElement.value es una propiedad de lectura y escritura de un elemento option. Al leerla obtienes una cadena, esté seleccionada o no la opción. Si existe el atributo HTML value, la propiedad devuelve su contenido, incluso "". Solo si el atributo falta se usa el texto de la opción: se eliminan los caracteres de espacio en blanco ASCII al principio y al final, y cada secuencia interna se reduce a un solo espacio. El atributo label no se usa para calcular este valor alternativo.

Asignar un valor a option.value crea o actualiza el atributo value sin cambiar el texto de la opción ni su estado de selección. Con option.removeAttribute("value") se vuelve a usar el texto. Define un valor explícito como "plan-pro" si el identificador debe permanecer estable aunque la etiqueta visible cambie o se traduzca.

En cambio, al leer select.value obtienes el valor de la primera opción seleccionada según el orden del árbol DOM, o "" si no hay ninguna. Por tanto, un resultado vacío no demuestra que no haya ninguna opción seleccionada. Esta API del DOM la define el estándar HTML, no ECMAScript; el ejemplo requiere un entorno con DOM de HTML.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>HTMLOptionElement.value example</title>
<script>
  const option = document.createElement("option");
  option.textContent = "  Pro\n  plan  ";
  console.log(JSON.stringify([option.value, option.getAttribute("value")]));

  option.value = "";
  console.log(JSON.stringify([option.value, option.getAttribute("value")]));

  option.value = "plan-pro";
  console.log(JSON.stringify([option.value, option.text]));

  option.removeAttribute("value");
  console.log(JSON.stringify([option.value, option.getAttribute("value")]));
</script>

Resultado

["Pro plan",null]
["",""]
["plan-pro","Pro plan"]
["Pro plan",null]

Guarda el ejemplo como archivo HTML y ábrelo en un navegador. El resultado aparece en la consola de desarrollo. `null` indica que el atributo no existe, no que esté vacío: en la segunda línea está presente y contiene `""`. No es necesario añadir el elemento a la página.

Lecciones relacionadas

  • JavaScript · Lección 43 · Intermedio · Versión: 3

Fuentes