Vai al contenuto
SilktideAiuto

Ruolo ARIA non valido

Silktide controlla ogni attributo role nelle tue pagine confrontandolo con l'elenco di ruoli definito dallo standard ARIA. Un ruolo scritto in modo errato, inventato, vuoto o riservato all'uso interno viene ignorato automaticamente dai browser, quindi il significato previsto dell'elemento non raggiunge mai le persone che ne dipendono.

<!-- Problema: "buton" non è un ruolo reale, quindi questo div resta privo di significato -->
<div role="buton" tabindex="0">Salva</div>

<!-- Correzione: usa un ruolo valido (o, meglio ancora, un vero elemento button) -->
<button>Salva</button>

Perché è importante

Un ruolo comunica alla che cos'è un elemento: un pulsante, una scheda, una finestra di dialogo. Quando il ruolo non è valido, i browser lo ignorano: un utente di ascolta testo semplice dove l'autore intendeva un controllo e potrebbe non avere alcun modo di sapere che è possibile interagire con l'elemento. Poiché la pagina appare e funziona normalmente per gli utenti vedenti che usano il mouse, questi errori passano inosservati senza test.

Come risolvere il problema

  1. Correggi gli errori di battitura affinché il ruolo corrisponda a un ruolo ARIA reale (elenco completo) - ad esempio role="navigation", non role="nav".
  2. Sostituisci i ruoli astratti (widget, composite, landmark, section e simili) con un ruolo concreto: i ruoli astratti esistono solo per organizzare lo standard e non devono essere usati nelle pagine.
  3. Rimuovi gli attributi role="" vuoti.
  4. Quando un elemento nativo ha il significato corretto (<button>, <nav>, <main>), preferiscilo e rimuovi completamente l'attributo role.

Come Silktide esegue questo controllo

  1. Trova ogni elemento della pagina con un attributo role.
  2. Segnala i valori di ruolo vuoti.
  3. Controlla ogni parola nel valore del ruolo rispetto ai ruoli definiti da ARIA 1.2. Sono accettati i ruoli delle estensioni per l'editoria digitale (doc-) e la grafica (graphics-).
  4. Segnala le parole che non corrispondono a nessun ruolo definito e quelle che indicano un ruolo astratto.

Risoluzione dei problemi

Il ruolo contiene più parole

Un attributo role può elencare più ruoli come alternative; i browser usano il primo che riconoscono. Silktide segnala ogni parola non valida o astratta nell'elenco, così puoi correggere anche le alternative.

Ulteriori informazioni

Ultimo aggiornamento

Questa pagina è stata utile?