Tilgængelighed på Magento: typiske WCAG-fejl og hvem der retter dem

På Magento kommer fundene typisk fra Luma-baserede temaer, tredjepartsmoduler og checkout, og de gentages på tusindvis af sider.

• image-alt1.1.1 Ikke-tekstbaseret indhold · A

  Billeder uden alt-attribut har intet tekstalternativ. Skærmlæserbrugere hører enten filnavnet (fx 'IMG_2043.jpg') eller ingenting og går glip af indholdet — fx et produktbillede, et kampagnebanner eller et betalingskort-ikon.

  Giv alle <img> en alt-attribut. Beskriv billedets indhold eller funktion i én kort sætning (uden 'billede af'). Er billedet rent dekorativt (rammer, skygger, spacer-gifs), så brug tom alt="" — så springer skærmlæseren det over. Et billede i et link skal beskrive linkets mål, ikke billedet. I webshops: produktbilleder bør nævne produktnavn og variant ('Sort uldfrakke, model Nora, set forfra'), og logoer bør have firmanavnet som alt.

  Før

  <img src="/img/frakke-nora-sort.jpg">

  Efter

  <img src="/img/frakke-nora-sort.jpg" alt="Sort uldfrakke, model Nora, set forfra">
  <img src="/img/border.gif" alt="">

• color-contrast1.4.3 Kontrast (minimum) · AA

  Tekstens kontrast mod baggrunden er under 4,5:1 (3:1 for stor tekst ≥ 18 pt eller ≥ 14 pt fed). Brugere med nedsat syn eller farvesynsdefekt — og alle på en mobil i sollys — kan ikke læse teksten. Rammer typisk lysegrå hjælpetekst, placeholder-tekst, priser på farvet baggrund og hvid tekst på pastelfarvede knapper.

  Mørkn tekstfarven eller lysn baggrunden, til kontrasten er mindst 4,5:1 (3:1 for stor tekst). axe angiver den målte kontrast og de præcise farver i fejlbeskrivelsen. Ret farven i design-tokens/CSS-variabler frem for pr. element, så det slår igennem overalt. Tjek også hover-, fokus- og disabled-tilstande (disabled-tekst er undtaget, men bør stadig kunne læses).

  Før

  .hint { color: #9ca3af; background: #ffffff; } /* 2,5:1 */

  Efter

  .hint { color: #4b5563; background: #ffffff; } /* 7,6:1 */

• link-name2.4.4 Formål med links (i kontekst) · A4.1.2 Navn, rolle, værdi · A

  Linket har ingen tilgængelig tekst. Skærmlæsere oplæser 'link' uden mål — brugeren ved ikke, hvor det fører hen. Typisk et link, der kun indeholder et ikon eller et billede uden alt, fx logo, kurv-ikon eller sociale medier-ikoner.

  Giv linket en tekst: enten synlig tekst, alt på billedet inde i linket, eller aria-label på <a>. Teksten skal beskrive målet ('Gå til kurv', 'Nordally — forside'), ikke 'klik her'. Har linket ingen href, er det ikke et link — brug en <button>.

  Før

  <a href="/kurv"><svg>…</svg></a>

  Efter

  <a href="/kurv" aria-label="Indkøbskurv, 2 varer"><svg aria-hidden="true">…</svg></a>

• aria-valid-attr4.1.2 Navn, rolle, værdi · A

  Elementet bruger en aria-*-attribut, der ikke findes (typisk en stavefejl som aria-lable eller aria-labeledby).

  Ret stavefejlen: aria-label, aria-labelledby, aria-describedby, aria-hidden, aria-expanded. Slå navnet op i ARIA-specifikationen.

  Før

  <button aria-lable="Luk">×</button>

  Efter

  <button aria-label="Luk">×</button>

• aria-required-attr4.1.2 Navn, rolle, værdi · A

  En ARIA-rolle mangler en attribut, som rollen kræver (fx role="checkbox" uden aria-checked, role="slider" uden aria-valuenow). Skærmlæseren kan ikke formidle elementets tilstand.

  Tilføj den påkrævede attribut og hold den opdateret via JavaScript, når tilstanden ændrer sig. Overvej det native element (<input type="checkbox">, <input type="range">), som håndterer det automatisk.

  Før

  <div role="checkbox">Nyhedsbrev</div>

  Efter

  <div role="checkbox" aria-checked="false" tabindex="0">Nyhedsbrev</div>

• meta-viewport1.4.4 Ændring af tekststørrelse · AA

  <meta name="viewport"> slår zoom fra (user-scalable=no eller maximum-scale=1). Brugere med nedsat syn kan ikke pinch-zoome på mobil — en meget almindelig og alvorlig fejl i webshops.

  Fjern user-scalable=no og maximum-scale. Standardværdien width=device-width, initial-scale=1 er alt, der behøves.

  Før

  <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no">

  Efter

  <meta name="viewport" content="width=device-width, initial-scale=1">