CKTIS / HTML
readonly — ovládací prvok formulára iba na čítanie
Logický atribút readonly bráni používateľovi upravovať podporované ovládacie prvky input a prvky textarea, nebráni však zmenám cez JavaScript a sám osebe nevylučuje hodnoty z odoslania formulára. Pri vlastných prvkoch priradených k formuláru je jeho vstavané správanie užšie.
Verzia: 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 je logický atribút: jeho prítomnosť zapína režim iba na čítanie. Platné zápisy zahŕňajú readonly, readonly="" a readonly="readonly". Zápis readonly="false" atribút nevypne – stále znamená, že je prítomný. Atribút odstráňte alebo nastavte vlastnosť JavaScriptu readOnly na false; všimnite si veľké O.
Atribút sa vzťahuje na textarea a tieto typy input: text, search, tel, url, email, password, date, month, week, time, datetime-local a number. Nevzťahuje sa na iné typy, napríklad checkbox, radio, range, file alebo tlačidlá, ani na select. Pri podporovaných prvkoch bráni používateľovi meniť hodnotu, skripty však môžu cez value stále priradiť novú hodnotu.
Na rozdiel od disabled atribút readonly prvok sám nevypína: zostáva dostupný pre fokus a jeho názov aj hodnota môžu byť podľa bežných pravidiel zahrnuté do údajov formulára. Prvok iba na čítanie je vyradený z validácie obmedzení (willValidate má hodnotu false); required sa nesmie používať spolu s readonly. Nepovažujte tento atribút za bezpečnostné opatrenie na ochranu integrity údajov – údaje odoslané klientom vyžadujú nezávislú validáciu na serveri.
Pri vlastnom prvku priradenom k formuláru prítomnosť readonly takisto vylučuje validáciu obmedzení. Prehliadač však úpravám automaticky nebráni: autor komponentu by mal toto správanie implementovať. Príklad ukazuje zmenu value skriptom, zahrnutie prvkov iba na čítanie do FormData a vynechanie prvku disabled.
Príklady
<!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>Výsledok
readOnly: true willValidate: false data: [["code","B23"],["note","Fixed text"]] readonly present: false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.