CKTIS / HTML
aria-disabled — stato disabilitato di un controllo
aria-disabled comunica alle tecnologie assistive che un elemento è percepibile, ma non disponibile per l’uso. L’attributo da solo non impedisce le azioni né rimuove l’elemento dall’ordine di tabulazione; l’autore deve implementare questo comportamento.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
aria-disabled="true" | aria-disabled="false"aria-disabled="true" identifica un elemento come disabilitato, ma ancora percepibile. aria-disabled="false" è il valore predefinito di questo stato; tuttavia, non annulla disabled nativo. Non è un attributo booleano HTML: specifica esplicitamente "true" o "false" invece di fare affidamento sulla sola presenza dell’attributo.
A differenza di disabled nativo, aria-disabled da solo non impedisce l’attivazione, non modifica l’ordine di tabulazione e non fornisce uno stile di disabilitazione. Preferisci disabled nativo quando soddisfa i requisiti. Se un pulsante non disponibile deve restare raggiungibile con Tab, usare aria-disabled richiede anche di sopprimere l’azione tramite uno script e indicare visivamente lo stato.
Lo stato si applica all’elemento e a tutti i suoi discendenti che possono ricevere il focus; quindi non applicarlo indiscriminatamente ai contenitori. Usalo solo dove lo consentono le regole HTML e il ruolo dell’elemento. ARIA 1.2 depreca il suo uso come stato globale, non l’attributo in sé.
Nell’esempio, il pulsante nativo mantiene il supporto alla tastiera, ma il gestore click condiviso termina prima di eseguire l’azione. CSS segnala soltanto l’indisponibilità; non la impone.
Esempi
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>aria-disabled demo</title>
<style>
button[aria-disabled="true"] { opacity: 0.6; }
</style>
<button type="button" id="save" aria-disabled="true">Save (unavailable)</button>
<p id="result">Actions: 0</p>
<script>
const save = document.getElementById('save');
const result = document.getElementById('result');
let actions = 0;
save.addEventListener('click', () => {
if (save.getAttribute('aria-disabled') === 'true') return;
actions += 1;
result.textContent = `Actions: ${actions}`;
});
save.click();
console.log(result.textContent);
</script>
</html>Risultato
Actions: 0
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.