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

CKTIS / JavaScript

Desativar controlos de formulários HTML com `disabled`

`disabled` desativa um controlo de formulário HTML e exclui-o da validação e dos dados do formulário. A propriedade `.disabled` e o seletor `:disabled` verificam coisas diferentes.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

<input name="city" disabled>
<script>
  const input = document.querySelector('input[name="city"]');
  input.disabled = true;
  input.disabled = false;
  input.matches(":disabled");
</script>

disabled é um atributo booleano de HTML: o que conta é a sua presença, pelo que até disabled="false" desativa o elemento. Aplica-se a elementos como input, button, select, textarea e a elementos personalizados associados a formulários. option e optgroup têm regras próprias: um optgroup desativado impede a seleção das suas opções, mas não desativa o próprio select.

Um fieldset desativado desativa os controlos descendentes, exceto os que estiverem dentro do primeiro elemento legend que seja seu filho direto, caso exista. Num input, .disabled reflete apenas o atributo do próprio campo: true adiciona-o e false remove-o. Usa input.matches(":disabled") para verificar o estado efetivo, incluindo o efeito de um fieldset.

O utilizador não pode dar o foco a um controlo desativado nem utilizá-lo normalmente, mas um script pode continuar a alterar, por exemplo, input.value. O navegador ignora o controlo na validação de restrições e ao construir os dados do formulário, também com new FormData(form). Nos campos de texto compatíveis, readonly impede a edição pelo utilizador e exclui o campo da validação de restrições, mas por si só não impede que receba o foco nem o exclui dos dados do formulário.

Estas funcionalidades pertencem à plataforma Web, não ao ECMAScript. Desativar um controlo não é uma medida de segurança: valida os dados e verifica as permissões no servidor.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Disabled form control</title>
</head>
<body>
  <script>
    const form = document.createElement("form");
    const group = document.createElement("fieldset");
    const input = document.createElement("input");
    input.name = "city";
    input.value = "Oslo";
    group.append(input);
    form.append(group);

    const report = () => console.log(JSON.stringify([
      input.disabled,
      input.matches(":disabled"),
      input.willValidate,
      new FormData(form).has("city")
    ]));

    group.disabled = true;
    report();
    group.disabled = false;
    report();
  </script>
</body>
</html>

Resultado

[false,true,false,false]
[false,false,true,true]

Cada linha mostra, por ordem, `.disabled`, se o campo corresponde a `:disabled`, `.willValidate` e se existe a entrada `city`. Reativar o `fieldset` altera os três últimos resultados; o campo nunca tem um atributo `disabled` próprio.

Lições relacionadas

  • JavaScript · Lição 20 · Intermédio · Versão: 3
  • JavaScript · Lição 21 · Intermédio · Versão: 3

Fontes