CKTIS / HTML
readonly — контрола във формуляр само за четене
Булевият атрибут readonly не позволява на потребителя да редактира поддържаните контроли input и елементите textarea, но не предотвратява промени чрез JavaScript и сам по себе си не изключва стойностите от изпращането на формуляра. При свързани с формуляр персонализирани елементи вграденото му поведение е по-ограничено.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<input type="text" name="code" value="A17" readonly>
<textarea name="note" readonly>Fixed text</textarea>
// JavaScript: element.readOnly = true; element.readOnly = false;readonly е булев атрибут: наличието му включва режим само за четене. Валидните форми включват readonly, readonly="" и readonly="readonly". Записът readonly="false" не изключва атрибута — той все още е налице. Премахнете атрибута или задайте JavaScript свойството readOnly на false; обърнете внимание на главната буква O.
Атрибутът се прилага към textarea и следните типове input: text, search, tel, url, email, password, date, month, week, time, datetime-local и number. Не се прилага към други типове, например checkbox, radio, range, file или бутони, нито към select. При поддържаните контроли той не позволява на потребителя да променя стойността, но скриптовете все пак могат да зададат нова стойност чрез value.
За разлика от disabled, readonly сам по себе си не деактивира контролата: тя остава достъпна за фокус, а името и стойността ѝ могат да бъдат включени в данните на формуляра според обичайните правила. Контрола само за четене е изключена от проверката на ограниченията (willValidate е false); required не трябва да се използва заедно с readonly. Не приемайте този атрибут за мярка за сигурност на целостта на данните — изпратените от клиента данни изискват независима проверка от страна на сървъра.
При персонализиран елемент, свързан с формуляр, наличието на readonly също го изключва от проверката на ограниченията. Браузърът обаче не предотвратява редактирането автоматично: авторът на компонента трябва да реализира това поведение. Примерът показва промяна на value от скрипт, включване на контролите само за четене във FormData и пропускане на контролата disabled.
Примери
<!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>Резултат
readOnly: true willValidate: false data: [["code","B23"],["note","Fixed text"]] readonly present: false
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.