HTML-i ligipääsetavuse audiitor

Enamik kiireid ligipääsetavuse kontrolle on kas pealiskaudne märksõnade skaneering või suur teek, mida pead usaldama kui musta kasti. See tööriist valib kolmanda tee: ta parsib sinu kleebitud HTML-i, kasutades brauseri enda sisseehitatud DOMParserit — ei mingit axe-core'i, välist ligipääsetavuse teeki ega allalaadimist — ning seejärel läbib saadud DOM-puu käsitsi kirjutatud kontrollide komplektiga, mis peegeldavad levinud, tõelisi WCAG 2.1 veamustreid. See tähendab, et loogika on täielikult kontrollitav ja audit toimub täielikult sinu brauseris: kleebitud märgendid ja iga kontrollitav värvipaar ei laadita kunagi üles ega saadeta kuhugi.

Kontrollid hõlmavad tõrkeid, mis ilmnevad tegelikel lehtedel kõige sagedamini: <img> elemendid, millel pole üldse alt atribuuti (tõeline WCAG viga, erinevalt teadlikult tühjast alt="", mida kasutatakse dekoratiivsete piltide puhul ja mis jäetakse õigesti märkimata); vormielemendid, mille puhul abitehnoloogia ei tea, milleks need on mõeldud (kontrollitakse iga tegeliku sildistamise viisi suhtes — sobiv <label for>, <label> elemendi sees olemine või aria-label/aria-labelledby atribuut); pealkirjatasemed, mis hüppavad ilma hoiatuseta (<h1> otse <h3>-ks või dokument, milles pole üldse <h1> või on neid rohkem kui üks); lingid, millel pole href-i või millel on ebamäärane, kontekstivaba tekst nagu "kliki siia" või "loe edasi"; ning puuduv lang atribuut, kui kleebitakse terve HTML-dokument (mitte ainult fragmendi).

Silmapaistev osa on ehtne kontrasti matemaatika, mitte pealiskaudne 'tundub loetav' heuristik. Iga elemendi jaoks, millel on reasisene color ja background-color, loeb tööriist mõlemad väärtused, teisendab need brauseri enda CSS-mootori abil tegelikeks RGB numbriteks (nii et hex, rgb(), hsl() ja nimelised värvid nagu 'tomato' töötavad identselt) ning arvutab iga kanali täpse WCAG suhtelise heleduse — L = 0,2126×R + 0,7152×G + 0,0722×B, kusjuures iga kanal on eelnevalt gamma-parandatud, kasutades tegelikku sRGB ülekandekõverat — enne kui ühendab need ametlikuks kontrastisuhte valemiks, (heledam L + 0,05) / (tumedam L + 0,05). Elemendi enda fondi suurus ja paksus määravad, kas kohaldatakse rangemaid 'tavalise teksti' lävendeid või leebemaid 'suure teksti' lävendeid (18pt+ või 14pt+ paks), ning tulemust kontrollitakse korraga kõigi nelja tõelise WCAG numbri suhtes: 4,5:1 ja 3:1 AA jaoks, 7:1 ja 4,5:1 AAA jaoks — mitte kunagi ei taandata seda üheks võltsiks hea/halb otsuseks.

See on teadlikult aus, pragmaatiline täieliku ligipääsetavuse auditi alamhulk, mitte sertifitseerimise tööriist: see ei hinda JavaScriptil põhinevat interaktiivsust, ARIA vidinate mustreid peale põhilise sildistamise, klaviatuuri fookuse järjekorda ega midagi, mis nõuab lehe tegelikku renderdamist ja käivitamist. Käsitle seda kui kiiret esimest läbimist, mis püüab enne lehe avaldamist kinni mõned kõige levinumad ja olulisemad WCAG vead — puuduvad alt-tekstid, sildistamata väljad, katkine pealkirjade hierarhia, madala kontrastsusega tekst ja ebamäärased lingid —, mida tuleks kasutada koos (mitte selle asemel) täieliku käsitsi ülevaatuse või spetsiaalse auditeerimise tööriistaga kõigele, mis läheb toodangusse.