CKTIS / HTML
aria-label — nome accessibile testuale
`aria-label` assegna un nome accessibile a un elemento il cui ruolo consente una denominazione fornita dall’autore.
Versione: WAI-ARIA 1.2
Sintassi
<button aria-label="Close notice">×</button>Fornisci un nome breve e localizzato dell’azione, per esempio Close notice per un pulsante di chiusura. L’attributo non assegna un ruolo a elementi arbitrari. Quando puoi usare testo visibile o un’etichetta nativa, generalmente è preferibile.
Il nome può sostituire il testo del contenuto. Includi l’etichetta visibile affinché il controllo vocale corrisponda allo schermo. Un aria-labelledby valido ha precedenza. Non è un suggerimento a comparsa, un’istruzione operativa né un gestore di eventi.
Il pulsante con icona dell’esempio ha nome Close notice, mentre il segno decorativo è escluso dall’accessibilità. Una funzione separata nasconde l’avviso all’attivazione. Il test conferma nome calcolato e chiusura; traduci l’etichetta insieme all’interfaccia.
Esempi
<!doctype html><meta charset="utf-8">
<p id="notice">Your settings were saved.</p>
<button id="close" aria-label="Close notice"><span aria-hidden="true">×</span></button>
<output id="result"></output>
<script>
document.querySelector('#close').addEventListener('click', () => { document.querySelector('#notice').hidden = true; });
document.querySelector('#close').click();
document.querySelector('#result').textContent = 'noticeHidden=' + document.querySelector('#notice').hidden;
</script>Risultato
noticeHidden=true
Verificati nome e azione del pulsante; ARIA da solo non chiude l’avviso.