CKTIS / JavaScript
Desactivar controles de formularios HTML con `disabled`
`disabled` desactiva un control de formulario HTML y lo excluye de la validación y de los datos del formulario. La propiedad `.disabled` y el selector `:disabled` comprueban cosas distintas.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
<input name="city" disabled>
<script>
const input = document.querySelector('input[name="city"]');
input.disabled = true;
input.disabled = false;
input.matches(":disabled");
</script>disabled es un atributo booleano de HTML: lo que cuenta es su presencia, por lo que incluso disabled="false" desactiva el elemento. Se aplica a elementos como input, button, select, textarea y los elementos personalizados asociados a formularios. option y optgroup tienen reglas propias: un optgroup desactivado impide seleccionar sus opciones sin desactivar el propio select.
Un fieldset desactivado desactiva sus controles descendientes, excepto los situados dentro del primer elemento legend que sea hijo directo suyo, si lo hay. En un input, .disabled solo refleja su propio atributo: true lo añade y false lo elimina. Usa input.matches(":disabled") para comprobar el estado efectivo, incluido el efecto de un fieldset.
El usuario no puede enfocar un control desactivado ni usarlo normalmente, pero un script aún puede modificar, por ejemplo, input.value. El navegador omite ese control tanto en la validación de restricciones como al construir los datos del formulario, también con new FormData(form). En los campos de texto compatibles, readonly impide que el usuario edite el campo y lo excluye de la validación de restricciones, pero por sí solo no impide que reciba el foco ni lo excluye de los datos del formulario.
Estas funciones pertenecen a la plataforma web, no a ECMAScript. Desactivar un control no es una medida de seguridad: valida los datos y comprueba los permisos en el servidor.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Disabled form control</title>
</head>
<body>
<script>
const form = document.createElement("form");
const group = document.createElement("fieldset");
const input = document.createElement("input");
input.name = "city";
input.value = "Oslo";
group.append(input);
form.append(group);
const report = () => console.log(JSON.stringify([
input.disabled,
input.matches(":disabled"),
input.willValidate,
new FormData(form).has("city")
]));
group.disabled = true;
report();
group.disabled = false;
report();
</script>
</body>
</html>Resultado
[false,true,false,false] [false,false,true,true]
Cada línea muestra, por orden, `.disabled`, si coincide con `:disabled`, `.willValidate` y si existe la entrada `city`. Al reactivar el `fieldset` cambian los tres últimos resultados; el campo nunca tiene su propio atributo `disabled`.
Lecciones relacionadas
- JavaScript · Lección 20 · Intermedio · Versión: 3
- JavaScript · Lección 21 · Intermedio · Versión: 3