Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

readonly — ovládací prvek formuláře pouze pro čtení

Logický atribut readonly brání uživateli v úpravách podporovaných ovládacích prvků input a prvků textarea, nebrání však změnám pomocí JavaScriptu a sám o sobě nevylučuje hodnoty z odeslání formuláře. U vlastních prvků přidružených k formuláři je jeho vestavěné chování omezenější.

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<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ý atribut: jeho přítomnost zapíná režim pouze pro čtení. Platné zápisy zahrnují readonly, readonly="" a readonly="readonly". Zápis readonly="false" atribut nevypne – stále znamená, že je přítomen. Atribut odstraňte nebo nastavte vlastnost JavaScriptu readOnly na false; všimněte si velkého O.

Atribut se vztahuje na textarea a následující typy input: text, search, tel, url, email, password, date, month, week, time, datetime-local a number. Nevztahuje se na jiné typy, například checkbox, radio, range, file nebo tlačítka, ani na select. U podporovaných prvků brání uživateli měnit hodnotu, skripty však mohou prostřednictvím value stále přiřadit novou hodnotu.

Na rozdíl od disabled atribut readonly prvek sám nevypíná: zůstává dostupný pro fokus a jeho název i hodnota mohou být podle běžných pravidel zahrnuty do dat formuláře. Prvek pouze pro čtení je vyřazen z validace omezení (willValidate má hodnotu false); required se nesmí používat společně s readonly. Nepovažujte tento atribut za bezpečnostní opatření pro integritu dat – data odeslaná klientem vyžadují nezávislou validaci na serveru.

U vlastního prvku přidruženého k formuláři přítomnost readonly rovněž vylučuje validaci omezení. Prohlížeč však úpravám automaticky nebrání: autor komponenty by měl toto chování implementovat. Příklad ukazuje změnu value skriptem, zahrnutí prvků pouze pro čtení do FormData a vynechání prvku disabled.

Pří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ýsledek

readOnly: true
willValidate: false
data: [["code","B23"],["note","Fixed text"]]
readonly present: false

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje