Saknade ID:n för ARIA-beskrivningar
Silktide kontrollerar element som kopplar extra beskrivande text till sig själva genom att hänvisa till andra element med ID, och rapporterar hänvisningar till ID:n som inte finns på sidan. En bruten hänvisning gör att beskrivningen inte visas.
ARIA-attributet aria-describedby kopplar ett element till kompletterande text
någon annanstans på sidan – hjälpt text under ett formulärfält eller en
förklaring av en kontroll:
<!-- Problem: hänvisningen säger "email-help", men styckets id är "email-helpp" -->
<input type="email" aria-describedby="email-help">
<p id="email-helpp">Ange din e-postadress på jobbet</p>
Varför detta är viktigt
Beskrivningar innehåller den vägledning som hjälper människor att undvika misstag – formatkrav, varningar och förklaringar av konsekvenser. En läser upp beskrivningen efter elementets namn, men bara om hänvisningen kan lösas. När den inte pekar på något får besökaren fältet utan vägledning och har inget sätt att veta att något saknas. Seende besökare ser fortfarande hjälptexten bredvid fältet, så felet passerar varje visuell granskning – vilket är precis varför automatiska kontroller är viktiga här.
Så här åtgärdar du det
- Leta reda på elementet som innehåller den beskrivande texten och se till att
värdet för
aria-describedbyexakt matchar dessid(ID:n är skiftlägeskänsliga):
<!-- Åtgärdat: hänvisningen matchar styckets id -->
<input type="email" aria-describedby="email-help">
<p id="email-help">Ange din e-postadress på jobbet</p>
- Om det beskrivande elementet har tagits bort återställer du det eller tar
bort det inaktuella attributet
aria-describedby. - När ett element beskrivs av flera andra element listar du alla ID:n, separerade med blanksteg, och kontrollerar vart och ett.
Så här testar Silktide detta
- Hitta alla element med attributet
aria-describedbypå varje sida. - Dela upp attributvärdet i enskilda ID:n.
- Rapportera varje hänvisat ID som inte finns någonstans på sidan.