Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti