Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri