CKTIS / HTML
readonly — ein schreibgeschütztes Formularsteuerelement
Das boolesche Attribut readonly verhindert die Bearbeitung durch Benutzer bei unterstützten input-Steuerelementen und textarea, nicht jedoch Änderungen durch JavaScript; außerdem schließt es Werte nicht selbst von der Formularübermittlung aus. Bei formulargebundenen benutzerdefinierten Elementen ist die integrierte Wirkung eingeschränkter.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<input type="text" name="code" value="A17" readonly>
<textarea name="note" readonly>Fixed text</textarea>
// JavaScript: element.readOnly = true; element.readOnly = false;readonly ist ein boolesches Attribut: Ist es vorhanden, wird der Nur-Lesen-Modus aktiviert. Gültige Schreibweisen sind readonly, readonly="" und readonly="readonly". readonly="false" schaltet das Attribut nicht aus – es bedeutet weiterhin, dass es vorhanden ist. Entferne das Attribut oder setze die JavaScript-Eigenschaft readOnly auf false; beachte das große O.
Das Attribut gilt für textarea und die folgenden input-Typen: text, search, tel, url, email, password, date, month, week, time, datetime-local und number. Für andere Typen wie checkbox, radio, range, file oder Schaltflächen sowie für select gilt es nicht. Bei unterstützten Steuerelementen verhindert es, dass Benutzer den Wert ändern; Skripte können über value weiterhin einen neuen Wert zuweisen.
Anders als disabled deaktiviert readonly das Steuerelement nicht: Es bleibt fokussierbar, und sein Name und Wert können nach den üblichen Regeln in die Formulardaten aufgenommen werden. Ein schreibgeschütztes Steuerelement nimmt nicht an der Einschränkungsvalidierung teil (willValidate ist false); required darf nicht zusammen mit readonly auftreten. Betrachte dieses Attribut nicht als Sicherheitsmaßnahme zur Datenintegrität – vom Client übermittelte Daten müssen unabhängig davon serverseitig validiert werden.
Bei einem formulargebundenen benutzerdefinierten Element verhindert das Vorhandensein von readonly ebenfalls die Einschränkungsvalidierung. Der Browser verhindert die Bearbeitung jedoch nicht automatisch; der Autor der Komponente sollte dieses Verhalten implementieren. Das Beispiel zeigt, wie ein Skript value ändert, schreibgeschützte Steuerelemente in FormData aufgenommen und das disabled-Steuerelement ausgelassen werden.
Beispiele
<!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>Ergebnis
readOnly: true willValidate: false data: [["code","B23"],["note","Fixed text"]] readonly present: false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.