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

CKTIS / HTML

conceito HTML: boolean-attributes

Os atributos booleanos HTML representam verdadeiro pela presença e falso apenas pela ausência; texto semelhante a um valor booleano não altera esta regra.

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

Sintaxe

<button disabled>…</button>

A regra aplica-se apenas a atributos definidos pela norma como booleanos, como disabled, checked e required; não a generalizes a atributos arbitrários. Uma propriedade IDL refletida costuma expor o estado booleano, enquanto o nó do atributo conserva o texto fornecido.

As formas presentes conformes incluem disabled="", disabled="disabled" e disabled="DISABLED", porque o nome canónico é comparado sem distinção de maiúsculas ASCII. disabled="false" não é conforme, mas o analisador mantém a presença, portanto o controlo continua desativado.

Para representar falso, remove o atributo com removeAttribute("disabled"), toggleAttribute("disabled", false) ou a atribuição refletida element.disabled = false. Não escrevas a palavra false nem suponhas que um modelo ou serializador corrige a intenção.

O exemplo compara disabled="false", disabled="DISABLED" e disabled="": os três produzem um estado disabled verdadeiro. Só atribuir false à propriedade remove o atributo, pelo que o resultado termina em after=false; present=false.

Exemplos

<!doctype html>
<meta charset="utf-8">
<button id="a" disabled="false">A</button>
<button id="b" disabled="DISABLED">B</button>
<button id="c" disabled="">C</button>
<output id="result"></output>
<script>
const before = [a.disabled, b.disabled, c.disabled].join(",");
a.disabled = false;
result.textContent = `before=${before}; after=${a.disabled}; present=${a.hasAttribute("disabled")}`;
</script>

Resultado

before=true,true,true; after=false; present=false

O exemplo executado confirma a semântica da presença e a fronteira entre texto de valor não conforme e remoção efetiva do atributo.

Fontes