Wijzig de Toegankelijkheidsdrempel (A11y)
Pas aan en geef prioriteit aan hoe uw organisatie omgaat met toegankelijkheidsproblemen
A11y is een op cijfers gebaseerde afkorting (of numeroniem) voor het woord „toegankelijkheid“, waarbij „11“ (elf) het aantal letters tussen de beginletter „a“ en de eindletter „y“ in toegankelijkheid vertegenwoordigt. Lees verder om meer te leren over de a11y drempel en de criteria die Axe Developer Hub gebruikt voor de berekening.
Wat Is de A11y Drempel?
De a11y drempel weerspiegelt de tolerantie van uw organisatie voor toegankelijkheidsfouten en is een cijfer dat wordt berekend op basis van twee criteria:
- Of de berekening alle toegankelijkheidsproblemen gebruikt die zijn gevonden door Axe Developer Hub tijdens uw testruns, of alleen nieuwe problemen die zijn ontdekt in de laatste testrun. (Detectie van nieuwe problemen is alleen beschikbaar voor webprojecten. Mobiele versie binnenkort beschikbaar!)
- Welke niveaus van impact (Kritiek, Ernstig, Matig en Klein) worden opgenomen in de drempelberekening.
Als u een van de criteria voor de a11y drempel wijzigt, alleen beïnvloedt de wijziging berekeningen in de toekomst. Oudere waarden van de a11y drempel worden niet opnieuw berekend. Er verschijnt een pictogram naast de berekening om aan te geven dat de configuratie is gewijzigd, en als u uw cursor erover beweegt, ziet u een herinnering dat de drempel is gewijzigd:
De a11y drempel stelt u in staat Axe Developer Hub aan te passen aan wat belangrijk is voor uw organisatie. Zijn nieuwe problemen de grootste zorg van uw organisatie, of wilt u alle problemen bijhouden? Welke impactniveaus moeten prioriteit krijgen?
Uw organisatie kan zich bijvoorbeeld momenteel alleen richten op het verminderen van kritieke problemen, of uw doel kan zijn om beide kritieke en ernstige problemen te verhelpen. Als uw organisatie net begint met het aanpakken van toegankelijkheidsproblemen, moet u mogelijk de impactniveaus die u prioriteit geeft beperken om niet overweldigd te raken. Later, naarmate de kennis van uw organisatie over het verminderen van toegankelijkheidsproblemen toeneemt, kunt u de a11y drempel veranderen om toegankelijkheidsproblemen met een lagere impact op te nemen.
Hoe Wordt de A11y Drempel Gebruikt?
De a11y drempel biedt een snelle indicatie van de toegankelijkheidskwaliteit van uw project en verschijnt prominent terwijl u verder in Axe Developer Hub graaft om problemen te identificeren. Elke waarde boven nul overschrijdt de toegestane toegankelijkheidsdrempel en geeft aan dat er problemen zijn die moeten worden aangepakt. Na verloop van tijd kunt u de toegankelijkheidsdrempel van commit naar commit en van release naar release bijhouden om een beeld van de toegankelijkheidsstatus van uw project te krijgen.
In het onderstaande voorbeeld ziet u de berekende a11y drempel in het linkerdeel van elk paneel. Hier geeft de waarde van 2 aan dat er twee problemen zijn die de huidige drempel overschrijden:
Door op de a11y drempelwaarde te klikken - hier, 2 - worden de problemen met overeenkomstige impactniveaus aan de filter toegevoegd, zodat u alleen de problemen ziet die de a11y drempel hebben overschreden. (In dit geval voegt klikken op 2 alle problemen toe aan de filter, omdat alles was ingesteld in de a11y-configuratie.)
Configureer de A11y Drempel
Alleen beheerders kunnen de criteria van de a11y drempel wijzigen. Dit zal het voor alle gebruikers van de onderneming veranderen.
Op uw Axe Account-pagina klikt u op het tabblad CONFIGURATIE bovenaan de pagina. Op de configuratiepagina selecteert u Axe Developer Hub uit de lijst aan de linkerkant van de pagina om de configuratie van de a11y drempel te bekijken en te bewerken.
Nadat u uw instellingen voor de a11y drempel heeft gewijzigd, klikt u op OPSLAAN.
Inbegrepen problemen
De Inbegrepen problemen waarde geeft aan of bij de drempelberekening alle toegankelijkheidsproblemen worden betrokken die aan de geselecteerde impacts voldoen, of alleen nieuwe toegankelijkheidsproblemen. Nieuw toegankelijkheidsproblemen zijn problemen die in uw huidige scan zijn gedetecteerd maar niet zijn gevonden in de scan waarmee het wordt vergeleken - of dat nu de vorige testrun, de vorige commit of de laatste scan op de standaardtak is. De weergegeven waarde voor de a11y drempel zal consistent zijn over alle pagina's wanneer deze is ingesteld om alle problemen op te nemen. Wanneer ingesteld om alleen naar nieuwe problemen te kijken, kan de waarde per pagina variëren, omdat elke pagina haar scan vergelijkt met een andere basislijn.
Opmerking: Detectie van nieuwe problemen is alleen beschikbaar voor webprojecten. Mobiele versie binnenkort.
Inbegrepen impacts
De Inbegrepen impacts waarde geeft aan welk impactniveau of welke impactniveaus moeten worden opgenomen in de berekening. Problemen met een Kritiek impact kunnen niet worden gedeselecteerd, aangezien deze problemen gebruikers met een beperking volledig verhinderen toegang te krijgen tot of interactie te hebben met een functie op een webpagina of mobiele app. Meer informatie over alle impactniveaus.
Het Gebruik van de A11y Drempel Met de GitHub Actie
Bij gebruik van de Axe Developer Hub GitHub Actie voor webprojecten, fungeert de a11y drempel als poortwachter om pullverzoeken te blokkeren die toegankelijkheidsproblemen bevatten. De actie voegt een opmerking toe aan het pullverzoek met een aanduiding van het probleem:
In het bovenstaande voorbeeld verwijst de pull request-opmerking naar een pagina op de Axe Developer Hub-website, waar u een lijst met mislukte problemen kunt bekijken. U kunt het standaardgedrag van de GitHub-actie wijzigen, zodat gebruikers alleen worden gewaarschuwd voor toegankelijkheidsproblemen in plaats van te verhinderen dat de pull request wordt samengevoegd.
Hoe het werkt
De GitHub-actie bevraagt de Axe Developer Hub-server (via het REST-eindpunt) voor de nieuwste commit die bij de pull request hoort. De webservice geeft het aantal toegankelijkheidsproblemen terug zoals bepaald door de a11y-drempelinstellingen. Elk aantal toegankelijkheidsfouten boven nul wordt als een mislukking beschouwd, wat een opmerking toevoegt aan de pull request en deze kan verhinderen te worden samengevoegd.
Zie Het gebruik van de GitHub-actie voor meer informatie.