CKTIS / HTML
readonly — kontrolnik obrazca samo za branje
Logični atribut readonly uporabniku preprečuje urejanje podprtih kontrolnikov input in elementov textarea, ne preprečuje pa sprememb z JavaScriptom in sam po sebi ne izloči vrednosti iz pošiljanja obrazca. Pri prilagojenih elementih, povezanih z obrazcem, je njegovo vgrajeno delovanje ožje.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<input type="text" name="code" value="A17" readonly>
<textarea name="note" readonly>Fixed text</textarea>
// JavaScript: element.readOnly = true; element.readOnly = false;readonly je logični atribut: njegova prisotnost vklopi način samo za branje. Veljavni zapisi so readonly, readonly="" in readonly="readonly". Zapis readonly="false" atributa ne izklopi – še vedno pomeni, da je prisoten. Odstranite atribut ali nastavite lastnost JavaScript readOnly na false; bodite pozorni na veliko črko O.
Atribut velja za textarea in naslednje vrste input: text, search, tel, url, email, password, date, month, week, time, datetime-local in number. Ne velja za druge vrste, kot so checkbox, radio, range, file ali gumbi, niti za select. Pri podprtih kontrolnikih uporabniku prepreči spreminjanje vrednosti, skripti pa lahko prek value še vedno nastavijo novo vrednost.
Za razliko od disabled atribut readonly kontrolnika sam po sebi ne onemogoči: še vedno lahko prejme fokus, njegovo ime in vrednost pa sta lahko po običajnih pravilih vključena v podatke obrazca. Kontrolnik samo za branje je izključen iz preverjanja omejitev (willValidate je false); required se ne sme pojaviti skupaj z readonly. Tega atributa ne obravnavajte kot varnostnega ukrepa za celovitost podatkov – podatke, poslane s strani odjemalca, je treba neodvisno preveriti na strežniku.
Pri prilagojenem elementu, povezanem z obrazcem, prisotnost readonly prav tako izključi preverjanje omejitev. Brskalnik pa urejanja ne prepreči samodejno: avtor komponente mora to vedenje implementirati. Primer prikazuje, kako skript spremeni value, kako so kontrolniki samo za branje vključeni v FormData in kako je kontrolnik disabled izpuščen.
Primeri
<!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>Rezultat
readOnly: true willValidate: false data: [["code","B23"],["note","Fixed text"]] readonly present: false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.