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 disabledHTMLInputElement 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
- HTML Living Standard — The input element
- HTML Living Standard — The textarea element
- HTML Living Standard — Enabling and disabling form controls: the disabled attribute
- HTML Living Standard — Constructing the entry list
- HTML Living Standard — Common event behaviors
- MDN — FormData: FormData() constructor
- MDN — disabled HTML attribute