Vai al contenuto
SilktideAiuto

ID delle descrizioni ARIA mancanti

Silktide controlla gli elementi che associano a sé testo descrittivo aggiuntivo facendo riferimento ad altri elementi tramite ID e segnala i riferimenti a ID che non esistono nella pagina. Un riferimento non valido elimina silenziosamente la descrizione.

L'attributo aria-describedby collega un elemento a un testo supplementare presente altrove nella pagina, ad esempio testo di aiuto sotto un campo di un modulo o una spiegazione di un controllo:

<!-- Problema: il riferimento indica "email-help", ma l'ID del paragrafo è "email-helpp" -->
<input type="email" aria-describedby="email-help">
<p id="email-helpp">Inserisci il tuo indirizzo email di lavoro</p>

Perché è importante

Le descrizioni forniscono indicazioni che aiutano le persone a non commettere errori: requisiti di formato, avvisi e spiegazioni delle conseguenze. Un legge la descrizione dopo il nome di un elemento, ma solo se il riferimento viene risolto. Quando non rimanda a nulla, il visitatore visualizza il campo senza le relative indicazioni e non ha modo di sapere che manca qualcosa. I visitatori vedenti continuano a vedere il testo di aiuto accanto al campo, quindi il problema sfugge a ogni revisione visiva: è proprio per questo che il controllo automatico è importante.

Come risolvere il problema

  1. Trova l'elemento che contiene il testo descrittivo e fai in modo che il valore di aria-describedby corrisponda esattamente al suo id (gli ID distinguono tra maiuscole e minuscole):
<!-- Corretto: il riferimento corrisponde all'ID del paragrafo -->
<input type="email" aria-describedby="email-help">
<p id="email-help">Inserisci il tuo indirizzo email di lavoro</p>
  1. Se l'elemento descrittivo è stato rimosso, ripristinalo oppure rimuovi l'attributo aria-describedby obsoleto.
  2. Quando un elemento è descritto da diversi altri elementi, elenca tutti gli ID separati da spazi e controllali uno per uno.

Come Silktide esegue il controllo

  1. Trova ogni elemento con un attributo aria-describedby in ogni pagina.
  2. Divide il valore dell'attributo in singoli ID.
  3. Segnala ogni ID di riferimento che non esiste in alcun punto della pagina.

Per saperne di più

Ultimo aggiornamento

Questa pagina è stata utile?

ID delle descrizioni ARIA mancanti | Guida di Silktide