Valore non valido dell’attributo ARIA
Silktide controlla il valore di ogni attributo ARIA nelle tue pagine rispetto ai valori consentiti dallo standard. Un attributo con un valore errato, ad esempio lo stato di una casella di controllo impostato su "yes" anziché "true", viene ignorato dai browser, quindi lo stato che descrive non viene mai annunciato.
<!-- Problema: "yes" non è un valore valido, lo stato viene ignorato -->
<div role="checkbox" aria-checked="yes">Iscriviti</div>
<!-- Correzione: usa il token definito -->
<div role="checkbox" aria-checked="true">Iscriviti</div>
Perché è importante
Ogni attributo definisce esattamente quali valori
accetta e i browser scartano qualsiasi altro valore anziché provare a
indovinarlo. Gli errori sono in genere valori che sembrano intuitivi, come
aria-expanded="1", aria-checked="yes", aria-level="0", che superano
ogni test visivo mentre gli utenti di
ricevono un controllo senza alcuno stato annunciato: un menu che non indica
mai se è aperto, una casella di controllo che non indica mai se è selezionata.
Come correggerlo
- Sostituisci i valori informali con i token definiti dall’attributo:
trueefalseanzichéyes,no,1o0. - Controlla gli attributi numerici: gli attributi di conteggio come
aria-levelearia-rowindexiniziano da 1, non da 0.
I valori esatti consentiti per ciascun attributo sono elencati nel riferimento agli attributi ARIA di MDN.
Come Silktide esegue questo controllo
- Trova ogni elemento nella pagina che contiene almeno un attributo
aria-. - Controlla il valore di ciascun attributo rispetto al tipo definito da ARIA 1.2:
attributi true/false, attributi a tre stati come
aria-checkedearia-pressed(true,false,mixedoundefined, che indica che lo stato non è impostato), numeri e numeri interi, nonché attributi con elenchi di parole fissi comearia-liveearia-current. - Segnala ogni valore non conforme, indicando quale valore era previsto.
Un attributo lasciato vuoto, come aria-live senza valore, non viene segnalato
qui. I browser ignorano un valore vuoto, quindi l’attributo si comporta come se
non fosse presente: un aria-live vuoto funziona come off. Se il ruolo
dell’elemento richiede l’attributo, Attributo ARIA obbligatorio mancante
lo segnala come mancante.
Gli attributi che fanno riferimento agli ID degli elementi sono verificati dai
propri controlli, come ID aria-controls mancante, mentre gli
attributi di testo libero come aria-label accettano qualsiasi testo.
Risoluzione dei problemi
Il valore è impostato da un framework
Le librerie di componenti talvolta serializzano gli stati in modo errato (ad
esempio, generando aria-expanded="null"). Il risultato punta all’elemento,
ma la correzione di solito riguarda la configurazione del componente o un
aggiornamento della libreria.