Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

readonly — um controlo de formulário só de leitura

O atributo booleano readonly impede a edição pelo utilizador nos controlos input suportados e nos elementos textarea, mas não impede alterações por JavaScript nem exclui, por si só, os valores do envio do formulário. Nos elementos personalizados associados a formulários, o comportamento integrado é mais limitado.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

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

readonly é um atributo booleano: a sua presença ativa o modo só de leitura. As formas válidas incluem readonly, readonly="" e readonly="readonly". Escrever readonly="false" não o desativa: o atributo continua presente. Remove o atributo ou define a propriedade JavaScript readOnly como false; repara no O maiúsculo.

O atributo aplica-se a textarea e aos seguintes tipos de input: text, search, tel, url, email, password, date, month, week, time, datetime-local e number. Não se aplica a outros tipos, como checkbox, radio, range, file ou botões, nem a select. Nos controlos suportados, impede o utilizador de alterar o valor, mas os scripts podem continuar a atribuir um novo valor através de value.

Ao contrário de disabled, readonly, por si só, não desativa o controlo: este continua a poder receber foco, e o seu nome e valor podem ser incluídos nos dados do formulário segundo as regras habituais. Um controlo só de leitura fica excluído da validação de restrições (willValidate é false); required não deve ser usado juntamente com readonly. Não encares este atributo como uma medida de segurança da integridade dos dados: os dados enviados pelo cliente precisam de validação independente no servidor.

Num elemento personalizado associado a um formulário, a presença de readonly também o exclui da validação de restrições. No entanto, o navegador não impede automaticamente a edição: quem desenvolve o componente deve implementar esse comportamento. O exemplo mostra um script a alterar value, a inclusão dos controlos só de leitura em FormData e a omissão do controlo disabled.

Exemplos

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

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes