Un pulsante con una semplice icona di lente può essere chiarissimo per chi vede la pagina. Per una persona che usa uno screen reader, invece, può diventare solo un elemento senza nome. Capire come usare aria label correttamente serve proprio a evitare questo scarto: rendere comprensibili comandi, campi e componenti che altrimenti resterebbero ambigui.
L’attributo `aria-label` è utile, ma non è una scorciatoia per rendere accessibile un sito. Se applicato senza criterio può perfino creare informazioni duplicate, incoerenti o invisibili a chi naviga con tecnologie assistive. Per aziende, e-commerce e servizi digitali soggetti ai requisiti WCAG 2.1 AA e all’European Accessibility Act, la differenza non è solo tecnica: riguarda la qualità del servizio, il rischio di non conformità e la fiducia delle persone.
Come usare aria-label correttamente: la regola base
`aria-label` assegna un nome accessibile a un elemento dell’interfaccia. Questo nome viene letto dalle tecnologie assistive e consente di capire che cosa fa un controllo, anche quando non esiste un testo visibile associato.
La regola più affidabile è semplice: usare `aria-label` soltanto quando il controllo non ha già un’etichetta testuale chiara e associata correttamente. Se un pulsante mostra la scritta “Invia richiesta”, aggiungere `aria-label=”Invia richiesta”` non porta un vantaggio reale. In alcuni contesti può generare una lettura ripetitiva o sovrascrivere un’etichetta più utile.
Un caso appropriato è il pulsante formato solo da un’icona:
“`html “`
In questo esempio, chi usa uno screen reader riceve l’informazione essenziale: “Cerca, pulsante”. L’icona SVG è nascosta all’albero di accessibilità perché decorativa rispetto al nome del comando.
Il valore dell’attributo deve descrivere lo scopo dell’azione, non l’aspetto grafico. “Lente di ingrandimento” racconta che cosa si vede; “Cerca” comunica che cosa accade attivando il pulsante. La seconda formulazione è quella utile.
Quando aria-label è la scelta giusta
Il ricorso a `aria-label` ha senso soprattutto nei componenti compatti, nelle interfacce ricche di icone e nelle azioni contestuali. Pensiamo a un pulsante per chiudere una finestra modale, a un comando per eliminare un prodotto dal carrello o a una navigazione con icona hamburger.
Il testo deve essere specifico quanto basta per il contesto. In una lista di prodotti, un generico `aria-label=”Rimuovi”` può essere insufficiente, perché la persona deve capire quale elemento verrà eliminato. Meglio fornire un nome completo:
“`html “`
Non sempre, però, `aria-label` è l’opzione preferibile. Se il testo visibile è disponibile, è spesso meglio collegarlo al controllo tramite `aria-labelledby`. Questo approccio mantiene allineata l’esperienza di chi vede la pagina e di chi la ascolta.
“`html
Offerta per il piano professionale
“`
Qui il pulsante acquisisce un nome contestuale senza nascondere informazioni in un attributo separato. Il risultato sarà più chiaro: “Offerta per il piano professionale, pulsante Dettagli”.
Per i campi di un modulo, la soluzione corretta resta quasi sempre l’elemento HTML `
“`html “`
Questo codice è più solido, più comprensibile da mantenere e più coerente con le aspettative delle tecnologie assistive.
Il nome accessibile deve restare coerente
Un errore frequente consiste nel far dire allo screen reader qualcosa di diverso da ciò che appare a schermo. Un bottone visibile con testo “Acquista ora” e `aria-label=”Completa pagamento”` può confondere chi alterna tastiera, sintesi vocale e vista residua. Inoltre, per molti comandi vocali, il nome accessibile dovrebbe includere il testo visibile: la persona deve poter pronunciare ciò che legge sul pulsante.
Se serve aggiungere contesto, mantenere quindi il testo visibile all’interno del nome. Per esempio, un pulsante “Aggiungi al carrello” relativo a un prodotto può avere `aria-label=”Aggiungi al carrello: Cuffie wireless”`. Il comando resta riconoscibile e acquisisce precisione.
Attenzione anche ai controlli che cambiano stato. Un pulsante per mostrare o nascondere un menu non dovrebbe limitarsi a un `aria-label` generico. Deve esporre anche lo stato effettivo con `aria-expanded`:
“`html “`
Quando il menu si apre, sia il valore di `aria-expanded` sia il nome, se necessario, devono essere aggiornati. Un’etichetta che continua a dire “Apri menu principale” mentre il menu è già aperto introduce un errore operativo.
Gli errori che compromettono l’accessibilità
L’uso improprio di ARIA spesso nasce dalla volontà di correggere rapidamente un componente grafico complesso. Il principio da seguire è invece: prima HTML semantico, poi ARIA soltanto dove serve. Un vero `
Quattro controlli meritano particolare attenzione:
- non inserire `aria-label` su elementi puramente decorativi o non interattivi, salvo casi tecnici specifici;
- non usare un testo vago come “clicca qui”, “icona” o “azione”;
- non duplicare nomi già presenti con testo visibile, `
- non affidarsi a `aria-label` per spiegare istruzioni, errori o vincoli di compilazione.
Per le istruzioni e i messaggi di errore, è preferibile collegare una descrizione con `aria-describedby`. Il nome identifica il campo, mentre la descrizione aggiunge dettagli. Sono due funzioni diverse e confonderle rende il modulo meno chiaro.
“`html
Usa almeno 12 caratteri.
“`
In questo caso, `aria-label` sarebbe superfluo. La struttura nativa offre già un nome e una descrizione leggibili.
Verificare aria-label prima della pubblicazione
Il controllo del codice non basta. Un attributo sintatticamente valido può comunque produrre un’esperienza poco comprensibile. La verifica deve unire scansioni automatiche, revisione manuale e test da tastiera.
Durante il controllo, occorre raggiungere ogni comando con il tasto Tab, verificare che l’indicatore di focus sia visibile e ascoltare il nome annunciato da uno screen reader. La domanda pratica è: senza vedere l’interfaccia, capisco che cosa farà questo elemento e in quale contesto mi trovo?
Gli strumenti automatici intercettano spesso pulsanti senza nome, campi privi di etichetta e conflitti ARIA evidenti. Non possono però stabilire se “Modifica” sia abbastanza specifico in una tabella con venti righe, né se il cambio di stato di un menu sia comunicato nel momento giusto. Per questo la remediation richiede valutazione umana, soprattutto nei flussi critici: registrazione, login, checkout, richiesta di preventivo e gestione dei documenti.
Per organizzazioni che gestiscono più siti o rilasciano aggiornamenti frequenti, il monitoraggio continuativo evita che una correzione venga annullata da una nuova componente, da un plugin o da un restyling. Inclusivia combina scansioni e supporto operativo proprio per trasformare le evidenze tecniche in interventi verificabili, utili anche nel percorso di conformità.
Un criterio operativo per team e fornitori
Inserire una revisione del nome accessibile nelle checklist di sviluppo riduce correzioni costose a progetto concluso. Designer, sviluppatori, marketing e fornitori esterni dovrebbero condividere una convenzione: ogni icona interattiva deve avere uno scopo esplicito, ogni campo deve avere una label reale, ogni componente dinamico deve comunicare stato e aggiornamenti.
Non è necessario aggiungere ARIA ovunque. È necessario scegliere il markup giusto e verificare l’esperienza reale. Prima di pubblicare una nuova funzionalità, chiedetevi se una persona che usa solo tastiera e sintesi vocale può comprenderla, azionarla e completare il percorso senza assistenza: è da questa verifica concreta che nasce un servizio digitale accessibile e difendibile.