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

CKTIS / HTML

aria-checked — estado assinalado de um controlo

`aria-checked` descreve o estado assinalado de um controlo com um papel adequado; não implementa o comportamento de uma caixa de seleção.

Versão: WAI-ARIA 1.2

Sintaxe

<button role="checkbox" aria-checked="mixed">All topics</button>

Numa caixa de seleção, usa as cadeias true, false ou mixed. Um estado ausente é indefinido, não desmarcado; o papel checkbox exige um estado explícito. O estado misto corresponde a um grupo parcialmente selecionado; os papéis radio e switch não o suportam. Não é um atributo booleano HTML ativado pela simples presença.

Prefere primeiro uma caixa de seleção nativa. Um controlo personalizado precisa de teclado, foco, etiqueta e aspeto coerente com o estado. Alterar apenas ARIA não assinala os campos associados.

O exemplo usa um botão nativo com semântica de caixa de seleção para gerir um grupo. Inicialmente está assinalado um tema; a ativação assinala ambos e atualiza o estado para verdadeiro. O teste verifica os campos reais e o estado na árvore de acessibilidade, não uma frase específica de um leitor de ecrã.

Exemplos

<!doctype html><meta charset="utf-8">
<button id="all" role="checkbox" aria-checked="mixed">All topics</button>
<label><input class="topic" type="checkbox" checked> HTML</label>
<label><input class="topic" type="checkbox"> CSS</label>
<output id="result"></output>
<script>
const all = document.querySelector('#all');
const topics = [...document.querySelectorAll('.topic')];
function sync() {
  const n = topics.filter(input => input.checked).length;
  all.setAttribute('aria-checked', n === 0 ? 'false' : n === topics.length ? 'true' : 'mixed');
}
topics.forEach(input => input.addEventListener('change', sync));
all.addEventListener('click', () => {
  const checked = all.getAttribute('aria-checked') !== 'true';
  topics.forEach(input => { input.checked = checked; }); sync();
});
all.click();
document.querySelector('#result').textContent = 'selected=' + topics.filter(x => x.checked).length + '; checked=' + all.getAttribute('aria-checked');
</script>

Resultado

selected=2; checked=true

O resultado mostra dois temas assinalados e o estado true. O comportamento é fornecido pelo tratamento do clique, não apenas por ARIA.

Fontes