Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

readonly — un contrôle de formulaire en lecture seule

L’attribut booléen readonly empêche l’utilisateur de modifier les contrôles input pris en charge et les éléments textarea, mais n’empêche pas les changements par JavaScript et n’exclut pas à lui seul les valeurs de l’envoi du formulaire. Pour les éléments personnalisés associés à un formulaire, son comportement intégré est plus limité.

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

Syntaxe

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

readonly est un attribut booléen : sa présence active le mode lecture seule. Les formes valides comprennent readonly, readonly="" et readonly="readonly". Écrire readonly="false" ne permet pas de le désactiver : l’attribut reste présent. Supprimez l’attribut ou définissez la propriété JavaScript readOnly sur false ; notez le O majuscule.

L’attribut s’applique à textarea et aux types input suivants : text, search, tel, url, email, password, date, month, week, time, datetime-local et number. Il ne s’applique pas aux autres types, tels que checkbox, radio, range, file ou les boutons, ni à select. Pour les contrôles pris en charge, il empêche l’utilisateur de modifier la valeur, mais les scripts peuvent toujours en affecter une nouvelle via value.

Contrairement à disabled, readonly ne désactive pas à lui seul le contrôle : celui-ci reste accessible au focus, et son nom et sa valeur peuvent être inclus dans les données du formulaire selon les règles habituelles. Un contrôle en lecture seule est exclu de la validation des contraintes (willValidate vaut false) ; required ne doit pas être utilisé avec readonly. Ne considérez pas cet attribut comme une mesure de sécurité garantissant l’intégrité des données : les données envoyées par le client doivent être validées indépendamment côté serveur.

Pour un élément personnalisé associé à un formulaire, la présence de readonly l’exclut également de la validation des contraintes. Toutefois, le navigateur n’empêche pas automatiquement la modification : l’auteur du composant doit implémenter ce comportement. L’exemple montre un script qui modifie value, l’inclusion des contrôles en lecture seule dans FormData et l’omission du contrôle disabled.

Exemples

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

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources