CKTIS / HTML
disabled: excluir interação e envio de um controlo
Distinga desativação, leitura apenas e autorização de segurança.
Versão: HTML Living Standard
Sintaxe
<fieldset disabled><legend>...</legend>...</fieldset>O booleano disabled desativa os controlos de formulário aplicáveis. Normalmente ficam excluídos do envio e da validação. Um fieldset desativado abrange descendentes, exceto os da primeira legenda. Opções e grupos têm regras próprias. Uma ligação de folha de estilos utiliza o mesmo atributo num mecanismo separado de carregamento e aplicação.
A presença ativa o estado desativado, mesmo com o texto false. Não equivale a readonly: um campo textual só de leitura pode continuar a ser enviado. JavaScript pode modificar controlos desativados e esta restrição cliente não substitui autorização servidor. Adicionar o atributo a uma ligação comum não a desativa.
O teste envia o campo da primeira legenda e o de leitura apenas, mas omite o obrigatório desativado. A validação passa porque este está excluído. Verificam-se essa exceção e os nomes realmente enviados.
Exemplos
<!doctype html><meta charset="utf-8">
<form id="form"><fieldset disabled><legend><label>Kept <input name="kept" value="A"></label></legend><label>Omitted <input id="omitted" name="omitted" required></label></fieldset>
<label>Read only <input name="readOnly" value="B" readonly></label></form><output id="result"></output><script>
const form = document.querySelector('#form');
document.querySelector('#result').textContent = 'fields=' + [...new FormData(form).keys()].join(',') + '; valid=' + form.checkValidity() + '; disabledWillValidate=' + document.querySelector('#omitted').willValidate;
</script>Resultado
fields=kept,readOnly; valid=true; disabledWillValidate=false
O campo obrigatório desativado está vazio; a exclusão da validação é verificada expressamente.