Gå til indhold
SilktideHjælp

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

  1. Erstat uformelle værdier med de tokens, attributten definerer: true og false i stedet for yes, no, 1 eller 0.
  2. Tjek numeriske attributter: tællende attributter som aria-level og aria-rowindex starter 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

  1. Find alle elementer på siden, der har mindst én aria-- attribut.
  2. 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-checked og aria-pressed (true, false, mixed eller undefined, hvilket betyder, at tilstanden ikke er angivet), tal og hele tal samt attributter med faste ordlister som aria-live og aria-current.
  3. 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.

Få mere at vide

Sidst opdateret

Var denne side nyttig?