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

CKTIS / HTML

readonly — un control de formulario de solo lectura

El atributo booleano readonly impide que el usuario edite los controles input compatibles y los elementos textarea, pero no evita los cambios mediante JavaScript ni excluye por sí solo los valores del envío del formulario. En los elementos personalizados asociados a formularios, su comportamiento integrado es más limitado.

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

Sintaxis

<input type="text" name="code" value="A17" readonly>
<textarea name="note" readonly>Fixed text</textarea>
// JavaScript: element.readOnly = true; element.readOnly = false;

readonly es un atributo booleano: su presencia activa el modo de solo lectura. Las formas válidas incluyen readonly, readonly="" y readonly="readonly". Escribir readonly="false" no sirve para desactivarlo: el atributo sigue estando presente. Elimina el atributo o establece la propiedad JavaScript readOnly en false; fíjate en la O mayúscula.

El atributo se aplica a textarea y a estos tipos de input: text, search, tel, url, email, password, date, month, week, time, datetime-local y number. No se aplica a otros tipos, como checkbox, radio, range, file o los botones, ni a select. En los controles compatibles, impide que el usuario cambie el valor, pero los scripts aún pueden asignar uno nuevo mediante value.

A diferencia de disabled, readonly por sí solo no desactiva el control: sigue pudiendo recibir el foco, y su nombre y valor pueden incluirse en los datos del formulario según las reglas habituales. Un control de solo lectura queda excluido de la validación de restricciones (willValidate es false); required no debe aparecer junto con readonly. No consideres este atributo una medida de seguridad para la integridad de los datos: los datos enviados por el cliente requieren una validación independiente en el servidor.

En un elemento personalizado asociado a un formulario, la presencia de readonly también lo excluye de la validación de restricciones. Sin embargo, el navegador no impide automáticamente la edición: quien desarrolle el componente debe implementar ese comportamiento. El ejemplo muestra un script que cambia value, la inclusión de controles de solo lectura en FormData y la omisión del control disabled.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>readonly demo</title>
<form id="demo">
  <label>Code <input name="code" value="A17" readonly></label>
  <label>Note <textarea name="note" readonly>Fixed text</textarea></label>
  <label>Excluded <input name="excluded" value="X" disabled></label>
</form>
<pre id="result"></pre>
<script>
  const form = document.getElementById('demo');
  const code = form.elements.namedItem('code');
  const lines = [
    `readOnly: ${code.readOnly}`,
    `willValidate: ${code.willValidate}`
  ];
  code.value = 'B23';
  lines.push(`data: ${JSON.stringify([...new FormData(form)])}`);
  code.readOnly = false;
  lines.push(`readonly present: ${code.hasAttribute('readonly')}`);
  document.getElementById('result').textContent = lines.join('\n');
</script>
</html>

Resultado

readOnly: true
willValidate: false
data: [["code","B23"],["note","Fixed text"]]
readonly present: false

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