CKTIS / HTML
readonly — een alleen-lezen formulierelement
Het booleaanse attribuut readonly voorkomt dat gebruikers ondersteunde input-elementen en textarea aanpassen, maar verhindert geen wijzigingen via JavaScript en sluit waarden niet vanzelf uit van formulierverzending. Voor formuliergekoppelde aangepaste elementen is de ingebouwde werking beperkter.
Versie: 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 is een booleaans attribuut: zodra het aanwezig is, wordt de alleen-lezenmodus ingeschakeld. Geldige vormen zijn readonly, readonly="" en readonly="readonly". readonly="false" schakelt het attribuut niet uit: het blijft aanwezig. Verwijder het attribuut of stel de JavaScript-eigenschap readOnly in op false; let op de hoofdletter O.
Het attribuut geldt voor textarea en de volgende typen input: text, search, tel, url, email, password, date, month, week, time, datetime-local en number. Het geldt niet voor andere typen, zoals checkbox, radio, range, file of knoppen, en ook niet voor select. Bij ondersteunde elementen kan de gebruiker de waarde niet wijzigen, maar scripts kunnen via value nog steeds een nieuwe waarde toewijzen.
Anders dan disabled schakelt readonly het element niet zelf uit: het blijft focusbaar en de naam en waarde ervan kunnen volgens de gebruikelijke regels in de formuliergegevens worden opgenomen. Een alleen-lezen element wordt uitgesloten van constraintvalidatie (willValidate is false); required mag niet samen met readonly voorkomen. Beschouw dit attribuut niet als beveiliging van de gegevensintegriteit: gegevens die door de client zijn verzonden, moeten onafhankelijk op de server worden gevalideerd.
Bij een formuliergekoppeld aangepast element sluit de aanwezigheid van readonly het element ook uit van constraintvalidatie. De browser voorkomt bewerken echter niet automatisch: de auteur van het component moet dat gedrag implementeren. Het voorbeeld laat zien hoe een script value wijzigt, hoe alleen-lezen elementen in FormData worden opgenomen en hoe het element met disabled wordt weggelaten.
Voorbeelden
<!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>Resultaat
readOnly: true willValidate: false data: [["code","B23"],["note","Fixed text"]] readonly present: false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.