Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

aria-checked — stato selezionato di un controllo

`aria-checked` descrive lo stato selezionato di un controllo con un ruolo appropriato; non implementa il comportamento di una casella.

Versione: WAI-ARIA 1.2

Sintassi

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

Per una casella usa le stringhe true, false o mixed. Uno stato assente è indefinito, non deselezionato; il ruolo checkbox richiede uno stato esplicito. Lo stato misto è adatto a un gruppo selezionato parzialmente; i ruoli radio e switch non lo supportano. Non è un attributo booleano HTML attivato dalla sola presenza.

Preferisci innanzitutto una casella nativa. Un controllo personalizzato richiede tastiera, focus, etichetta e aspetto coerente con il suo stato. Cambiare soltanto ARIA non seleziona i campi associati.

L’esempio usa un pulsante nativo con semantica checkbox per gestire un gruppo. Inizialmente è selezionato un argomento; l’attivazione li seleziona entrambi e aggiorna lo stato a vero. Il test verifica i campi effettivi e lo stato nell’albero di accessibilità, non una frase precisa di un lettore di schermo.

Esempi

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

Risultato

selected=2; checked=true

Il risultato mostra due argomenti selezionati e lo stato true. Il comportamento viene dal gestore del clic, non da ARIA da solo.

Fonti