Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

readonly — pole formularza tylko do odczytu

Atrybut logiczny readonly blokuje edycję przez użytkownika w obsługiwanych polach input i w textarea, ale nie blokuje zmian przez JavaScript ani sam w sobie nie wyklucza wartości z wysyłania formularza. W elementach niestandardowych powiązanych z formularzem ma węższe działanie wbudowane.

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

Składnia

<input type="text" name="code" value="A17" readonly>
<textarea name="note" readonly>Fixed text</textarea>
// JavaScript: element.readOnly = true; element.readOnly = false;

readonly jest atrybutem logicznym: jego obecność włącza tryb tylko do odczytu. Poprawne zapisy to readonly, readonly="" i readonly="readonly". Zapis readonly="false" nie jest poprawnym sposobem wyłączenia atrybutu — nadal oznacza jego obecność. Usuń atrybut albo ustaw właściwość JavaScript readOnly na false; zwróć uwagę na wielką literę O.

Atrybut dotyczy textarea oraz typów input: text, search, tel, url, email, password, date, month, week, time, datetime-local i number. Nie stosuje się go do pozostałych typów, takich jak checkbox, radio, range, file czy przyciski, ani do select. W obsługiwanych polach uniemożliwia użytkownikowi zmianę wartości, lecz skrypt nadal może przypisać nową wartość przez value.

W przeciwieństwie do disabled, samo readonly nie wyłącza kontrolki: pozostaje ona dostępna dla fokusu, a jej nazwa i wartość mogą trafić do danych formularza zgodnie ze zwykłymi regułami. Pole tylko do odczytu jest wyłączone z walidacji ograniczeń (willValidate ma wartość false); required nie może występować razem z readonly. Nie traktuj tego atrybutu jako zabezpieczenia integralności danych — dane przesłane przez klienta wymagają niezależnej walidacji po stronie serwera.

Dla elementu niestandardowego powiązanego z formularzem obecność readonly również wyklucza walidację ograniczeń. Przeglądarka nie dodaje jednak automatycznej blokady edycji: autor komponentu powinien ją zaimplementować. Przykład pokazuje zmianę value przez skrypt, uwzględnienie pól tylko do odczytu w FormData oraz pominięcie pola disabled.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła