Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / HTML

readonly — kontrola obrasca samo za čitanje

Logički atribut readonly korisniku onemogućuje uređivanje podržanih kontrola input i elemenata textarea, ali ne sprječava promjene putem JavaScripta niti sam po sebi isključuje vrijednosti iz slanja obrasca. Kod prilagođenih elemenata povezanih s obrascem ugrađeno je ponašanje uže.

Verzija: 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čki atribut: njegova prisutnost uključuje način rada samo za čitanje. Valjani zapisi uključuju readonly, readonly="" i readonly="readonly". Zapis readonly="false" ne isključuje atribut – on je i dalje prisutan. Uklonite atribut ili postavite JavaScript svojstvo readOnly na false; obratite pozornost na veliko O.

Atribut se primjenjuje na textarea i sljedeće vrste input: text, search, tel, url, email, password, date, month, week, time, datetime-local i number. Ne primjenjuje se na druge vrste, kao što su checkbox, radio, range, file ili gumbi, niti na select. Kod podržanih kontrola sprječava korisnika da promijeni vrijednost, ali skripte i dalje mogu dodijeliti novu vrijednost putem value.

Za razliku od disabled, readonly sam po sebi ne onemogućuje kontrolu: ona i dalje može primiti fokus, a njezin naziv i vrijednost mogu se, prema uobičajenim pravilima, uključiti u podatke obrasca. Kontrola samo za čitanje izuzeta je iz provjere ograničenja (willValidate je false); required se ne smije pojaviti zajedno s readonly. Nemojte ovaj atribut smatrati sigurnosnom mjerom za cjelovitost podataka – podatke koje šalje klijent treba neovisno provjeriti na poslužitelju.

Kod prilagođenog elementa povezanog s obrascem prisutnost atributa readonly također isključuje provjeru ograničenja. Međutim, preglednik automatski ne sprječava uređivanje: autor komponente treba implementirati takvo ponašanje. Primjer prikazuje kako skripta mijenja value, kako se kontrole samo za čitanje uključuju u FormData te kako se kontrola disabled izostavlja.

Primjeri

<!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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori