Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

readonly — un controllo del modulo di sola lettura

L’attributo booleano readonly impedisce all’utente di modificare i controlli input supportati e gli elementi textarea, ma non impedisce le modifiche tramite JavaScript né esclude da solo i valori dall’invio del modulo. Per gli elementi personalizzati associati a un modulo, il comportamento integrato è più limitato.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

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

readonly è un attributo booleano: la sua presenza attiva la modalità di sola lettura. Le forme valide includono readonly, readonly="" e readonly="readonly". Scrivere readonly="false" non lo disattiva: l’attributo risulta comunque presente. Rimuovi l’attributo oppure imposta la proprietà JavaScript readOnly su false; nota la O maiuscola.

L’attributo si applica a textarea e ai seguenti tipi di input: text, search, tel, url, email, password, date, month, week, time, datetime-local e number. Non si applica agli altri tipi, come checkbox, radio, range, file o i pulsanti, né a select. Nei controlli supportati impedisce all’utente di cambiare il valore, ma gli script possono comunque assegnarne uno nuovo tramite value.

A differenza di disabled, readonly da solo non disattiva il controllo: questo resta raggiungibile con il focus e il suo nome e valore possono essere inclusi nei dati del modulo secondo le regole abituali. Un controllo di sola lettura è escluso dalla convalida dei vincoli (willValidate è false); required non deve comparire insieme a readonly. Non considerare questo attributo una misura di sicurezza per l’integrità dei dati: i dati inviati dal client richiedono una convalida indipendente sul server.

Per un elemento personalizzato associato a un modulo, la presenza di readonly lo esclude anch’essa dalla convalida dei vincoli. Tuttavia, il browser non impedisce automaticamente le modifiche: chi sviluppa il componente deve implementare questo comportamento. L’esempio mostra uno script che cambia value, l’inclusione dei controlli di sola lettura in FormData e l’esclusione del controllo disabled.

Esempi

<!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>

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti