Vai al contenuto
SilktideAiuto

ID delle etichette ARIA mancanti

Silktide controlla gli elementi che ricavano il proprio da altri elementi tramite ID e segnala i riferimenti a ID che non esistono nella pagina. Un riferimento non valido lascia l'elemento senza il nome che avrebbe dovuto avere.

L'attributo aria-labelledby identifica un elemento puntando all'id dell'elemento che contiene la relativa etichetta: per esempio, un'intestazione che identifica una finestra di dialogo o una didascalia che identifica un controllo:

<!-- Problema: il riferimento indica "dialog-label", ma l'id dell'intestazione è "dialog-labell" -->
<h2 id="dialog-labell">Messaggio importante!</h2>
<div role="dialog" aria-labelledby="dialog-label">

Perché è importante

Il nome accessibile è ciò che un annuncia quando un visitatore raggiunge un elemento. Quando un riferimento aria-labelledby non punta a nulla, l'elemento potrebbe essere annunciato senza alcun nome: una finestra di dialogo senza nome, un pulsante senza nome; il visitatore deve quindi indovinarne lo scopo. Questi problemi sono invisibili: la pagina appare identica e persino test accurati con gli utenti raramente rilevano un nome che non è stato associato correttamente senza che nulla lo segnali. Gli ID vengono rinominati e i contenuti ristrutturati, quindi i riferimenti diventano obsoleti nel tempo.

Come risolvere il problema

  1. Individua l'elemento che avrebbe dovuto fornire il nome e fai in modo che il valore di aria-labelledby corrisponda esattamente al suo id (gli ID distinguono tra maiuscole e minuscole):
<!-- Corretto: il riferimento corrisponde all'id dell'intestazione -->
<h2 id="dialog-label">Messaggio importante!</h2>
<div role="dialog" aria-labelledby="dialog-label">
  1. Se l'elemento che forniva l'etichetta è stato rimosso, ripristinalo oppure usa un attributo aria-label contenente il nome come testo.
  2. Quando un elemento è identificato da diversi altri elementi, elenca tutti gli ID separandoli con spazi e controllali uno per uno.

Come Silktide esegue il controllo

  1. Individua ogni elemento con un attributo aria-labelledby in ciascuna pagina.
  2. Divide il valore dell'attributo in singoli ID.
  3. Segnala ogni ID referenziato che non esiste in alcun punto della pagina.

Per saperne di più

Ultimo aggiornamento

Questa pagina è stata utile?

ID delle etichette ARIA mancanti | Guida di Silktide