Vai al contenuto
SilktideAiuto

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

  1. Sostituisci i valori informali con i token definiti dall’attributo: true e false anziché yes, no, 1 o 0.
  2. Controlla gli attributi numerici: gli attributi di conteggio come aria-level e aria-rowindex iniziano 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

  1. Trova ogni elemento nella pagina che contiene almeno un attributo aria-.
  2. Controlla il valore di ciascun attributo rispetto al tipo definito da ARIA 1.2: attributi true/false, attributi a tre stati come aria-checked e aria-pressed (true, false, mixed o undefined, che indica che lo stato non è impostato), numeri e numeri interi, nonché attributi con elenchi di parole fissi come aria-live e aria-current.
  3. 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.

Ulteriori informazioni

Ultimo aggiornamento

Questa pagina è stata utile?