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

CKTIS / JavaScript

`value` y `disabled` en los elementos `input` y `textarea`

Lee y cambia el valor de un control sin depender de si el usuario puede usarlo. Distingue el atributo `disabled` del propio elemento de su estado efectivo y averigua qué valores se incluyen en los datos del formulario.

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

Sintaxis

control.value          // read a string
control.value = text   // write a string; input.type determines the rules
control.disabled       // read the element's own disabled attribute as a boolean
control.disabled = true
control.disabled = false
control.matches(':disabled') // test whether the control is actually disabled

HTMLInputElement y HTMLTextAreaElement son interfaces del DOM definidas por el estándar HTML, no por ECMAScript 2024. En los campos de texto y en textarea, value lee y escribe la cadena actual. En textarea, value normaliza los saltos de línea a LF (\n). El valor predeterminado (defaultValue) procede del atributo value de input o del contenido de texto de textarea. Después de una edición del usuario o una asignación a value, cambiar el valor predeterminado ya no sobrescribe el actual. Al restablecer el formulario, el valor actual se establece a partir del predeterminado. En input, el navegador también aplica el algoritmo de saneamiento del valor si el tipo lo define. Por ejemplo, con type="text", el restablecimiento elimina los saltos de línea de value aunque estén presentes en defaultValue.

En input, type determina cómo funciona value. En el modo de valor, como en text y number, el navegador puede transformar o vaciar la cadena asignada según las reglas del tipo; number también devuelve una cadena. En hidden, value refleja el atributo value y devuelve '' si no está presente. En checkbox y radio también refleja el atributo, pero devuelve 'on' si falta; usa checked para consultar si está seleccionado. En file, value no revela la ruta real: usa files. Asignar '' borra la selección; una cadena no vacía provoca InvalidStateError.

La propiedad booleana disabled solo refleja el atributo del propio elemento: true lo añade y false lo quita. En HTML, incluso disabled="false" deshabilita el control, porque basta con que el atributo esté presente. Un control con disabled === false puede estar deshabilitado por un fieldset antecesor deshabilitado, salvo si se encuentra dentro del primer hijo legend de ese grupo. Comprueba el estado efectivo con control.matches(':disabled').

Un control deshabilitado no puede recibir el foco ni ser editado por el usuario. Queda excluido de la validación de restricciones y no se incluye al enviar el formulario ni al crear new FormData(form). Un script puede seguir leyendo y escribiendo value; la asignación por sí sola no dispara input ni change. Donde esté disponible, usa readOnly para permitir el foco sin permitir la edición; por sí solo no excluye el campo del envío. Ninguno de estos estados reemplaza la validación ni la autorización en el servidor.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Form control value and disabled state</title>
</head>
<body>
<script>
(() => {
  const form = document.createElement('form');
  const group = document.createElement('fieldset');
  const input = document.createElement('input');
  const textarea = document.createElement('textarea');
  input.type = 'text';
  input.name = 'title';
  textarea.name = 'note';
  group.append(input);
  form.append(group, textarea);

  group.disabled = true;
  input.value = 'Draft';
  textarea.value = 'Line 1\r\nLine 2';
  console.log(JSON.stringify([input.value, input.disabled, input.matches(':disabled')]));
  console.log(JSON.stringify([...new FormData(form)]));

  group.disabled = false;
  textarea.disabled = true;
  console.log(JSON.stringify([...new FormData(form)]));
})();
</script>
</body>
</html>

Resultado

["Draft",false,true]
[["note","Line 1\nLine 2"]]
[["title","Draft"]]

Guarda el ejemplo como archivo HTML, ábrelo en un navegador y consulta la consola del navegador. La primera línea muestra que se puede asignar `Draft` aunque el campo esté deshabilitado y su propiedad `disabled` sea `false`. Las dos líneas siguientes muestran los datos antes y después de cambiar el estado de los controles; JSON representa el salto de línea LF como `\n`.

Lecciones relacionadas

  • JavaScript · Lección 4 · Avanzado · Versión: 4

Fuentes