Ugyldig ARIA-attributværdi
Silktide tjekker værdien af alle ARIA-attributter på dine sider i forhold til de værdier, som standarden tillader for dem. En attribut med en forkert værdi, som f.eks. en afkrydsningsfelttilstand på "yes" i stedet for "true", ignoreres af browsere, så den tilstand, den beskriver, aldrig bliver annonceret.
<!-- Problem: "yes" er ikke en gyldig værdi, tilstanden udelades -->
<div role="checkbox" aria-checked="yes">Abonnér</div>
<!-- Løsning: brug det definerede token -->
<div role="checkbox" aria-checked="true">Abonnér</div>
Hvorfor dette er vigtigt
Hver -attribut definerer præcist, hvilke værdier
den accepterer, og browsere kasserer alt andet i stedet for at gætte. Fejlene
er typisk værdier, der ser intuitive ud – aria-expanded="1",
aria-checked="yes", aria-level="0" – og som består alle visuelle tests,
mens brugere af får et
kontrolelement uden en annonceret tilstand: en menu, der aldrig angiver, om
den er åben, eller et afkrydsningsfelt, der aldrig angiver, om det er markeret.
Sådan løser du det
- Erstat uformelle værdier med de tokens, attributten definerer:
trueogfalsei stedet foryes,no,1eller0. - Tjek numeriske attributter: tællende attributter som
aria-levelogaria-rowindexstarter ved 1, ikke 0.
De nøjagtige værdier, der er tilladt for hver attribut, er angivet i MDN's reference for ARIA-attributter.
Sådan tester Silktide dette
- Find alle elementer på siden, der har mindst én
aria-- attribut. - Tjek hver attributs værdi i forhold til den type, som ARIA 1.2 definerer for den:
true/false-attributter, attributter med tre tilstande som
aria-checkedogaria-pressed(true,false,mixedellerundefined, hvilket betyder, at tilstanden ikke er angivet), tal og hele tal samt attributter med faste ordlister somaria-liveogaria-current. - Rapportér hver værdi, der ikke overholder kravene, og angiv, hvad der var forventet.
En attribut, der efterlades tom, som f.eks. aria-live uden værdi, rapporteres
ikke her. Browsere ignorerer en tom værdi, så attributten opfører sig, som om
den ikke var der: en tom aria-live fungerer på samme måde som off. Hvis
elementets rolle kræver attributten, rapporterer Manglende påkrævet ARIA-attribut
den som manglende.
Attributter, der henviser til element-id'er, testes af deres egne tjek, som
f.eks. Manglende aria-controls-id, og fritekstattributter
som aria-label accepterer enhver tekst.
Fejlfinding
Værdien angives af et framework
Komponentbiblioteker serialiserer af og til tilstande forkert (for eksempel
ved at gengive aria-expanded="null"). Fundet peger på elementet, men
løsningen hører som regel hjemme i konfigurationen af komponenten eller i en
opdatering af biblioteket.