Wijzig de Toegankelijkheidsdrempel (A11y)
Pas aan en prioriteer hoe uw organisatie omgaat met toegankelijkheidskwesties
A11y is een cijfergebaseerde afkorting (of numeroniem) voor het woord „toegankelijkheid“, met „11“ (elf) dat het aantal karakters vertegenwoordigt tussen de begin „t“ en eind „d“ in toegankelijkheid. Lees verder om meer te weten te komen over de a11y-drempel en de criteria die Axe Developer Hub gebruikt voor de berekening ervan.
Wat is de A11y-drempel?
De a11y-drempel weerspiegelt de tolerantie van uw organisatie voor toegankelijkheidsfouten en is een getal dat wordt berekend op basis van twee criteria:
- Of de berekening alle toegankelijkheidskwesties omvat die door Axe Developer Hub tijdens uw testuitvoeringen zijn gevonden, of alleen nieuwe kwesties ontdekt in de laatste testuitvoering. (Detectie van nieuwe kwesties is alleen beschikbaar voor webprojecten. Mobiel binnenkort!)
- Welke niveaus van impact (Kritiek, Ernstig, Gemiddeld en Klein) worden opgenomen in de drempelberekening.
Als u een van de criteria voor de a11y-drempel wijzigt, heeft de wijziging alleen invloed op toekomstige berekeningen. Oudere a11y-drempelwaarden worden niet opnieuw berekend. Een pictogram zal naast de berekening verschijnen 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 de Axe Developer Hub aan te passen aan wat belangrijk is voor uw organisatie. Zijn nieuwe kwesties de belangrijkste zorg van uw organisatie, of wilt u alle kwesties bijhouden? Welke impactniveaus moeten worden geprioriteerd?
Uw huidige focus kan bijvoorbeeld alleen liggen op het verminderen van kritieke kwesties, of uw doel kan zijn om zowel kritieke als ernstige kwesties op te lossen. Als uw organisatie net begint met het aanpakken van toegankelijkheidskwesties, moet u mogelijk de impactniveaus die u prioriteert, beperken om niet overweldigd te raken. Later, naarmate de kennis van uw organisatie in het mitigeren van toegankelijkheidskwesties toeneemt, kunt u de a11y-drempel wijzigen om kwesties 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 als u dieper ingaat op het identificeren van kwesties in Axe Developer Hub. Elke waarde boven nul overschrijdt de toegestane toegankelijkheidsdrempel en duidt op kwesties die moeten worden aangepakt. In de loop van de tijd kunt u de toegankelijkheidsdrempel van commit tot commit en van release tot release volgen om een beeld te krijgen van de toegankelijkheidsstatus van uw project.
In het onderstaande voorbeeld ziet u de berekende a11y-drempel in het linker gedeelte van elk paneel. Hier geeft de waarde 2 aan dat er twee kwesties zijn die de huidige drempel overschrijden:
Door op de a11y-drempelwaarde te klikken - hier, 2 - worden de kwesties met bijbehorende impactniveaus aan het filter toegevoegd, zodat u alleen kunt inzoomen op de kwesties die de a11y-drempel overschreden. (In dit geval, door op 2 te klikken, worden alle kwesties aan het filter toegevoegd, omdat alle kwesties in de a11y-configuratie waren ingesteld.)
Configureer de A11y-drempel
Alleen beheerders kunnen de a11y-drempelcriteria wijzigen. Dit zal het voor alle gebruikers van de onderneming wijzigen.
Op uw Axe-accountpagina 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 a11y-drempelinstellingen heeft gewijzigd, klikt u op OPSLAAN.
Inbegrepen problemen
De Inbegrepen problemen waarde geeft aan of u in de drempelberekening alle toegankelijkheidsproblemen die voldoen aan de geselecteerde impactniveaus wilt opnemen, of alleen nieuwe toegankelijkheidsproblemen. Nieuwe toegankelijkheidsproblemen zijn die problemen die zijn gedetecteerd in uw huidige scan en niet zijn gevonden in de scan waarmee deze wordt vergeleken - of dat nu de vorige testuitvoering is, de vorige commit, of de laatste scan op de standaardtak. De waarde die wordt weergegeven voor de a11y-drempel zal consistent zijn over alle pagina's wanneer ingesteld op het opnemen van alle problemen. Wanneer ingesteld op alleen nieuwe problemen bekijken, kan de waarde per pagina variëren, omdat elke pagina zijn scan vergelijkt met een andere basislijn.
Opmerking: Detectie van nieuwe problemen is alleen beschikbaar voor webprojecten. Mobiel komt binnenkort.
Inbegrepen impactniveaus
De Inbegrepen impactniveaus waarde geeft aan welk impactniveau of welke impactniveaus in de berekening moeten worden opgenomen. Problemen met Kritieke impact kunnen niet worden uitgeschakeld, omdat deze problemen gebruikers met een handicap volledig verhinderen om toegang te krijgen tot of om te gaan met een functie op een webpagina of mobiele app. Lees meer over alle impactniveaus.
De A11y-drempel gebruiken met de GitHub-actie
Bij het gebruik van de Axe Developer Hub GitHub-actie voor webprojecten, fungeert de a11y-drempel als een poortwachter om pull requests die toegankelijkheidsproblemen bevatten te blokkeren. De actie voegt een opmerking toe aan de pull request die het probleem aangeeft:
In het bovenstaande voorbeeld linkt de pull request-opmerking naar een pagina op de Axe Developer Hub-website waar u een lijst met problemen kunt bekijken die zijn mislukt. U kunt het standaardgedrag van de GitHub-actie wijzigen om gebruikers alleen te waarschuwen voor toegankelijkheidsproblemen in plaats van de pull request te blokkeren van samenvoeging.
Hoe het werkt
De GitHub-actie raadpleegt de Axe Developer Hub-server (via het REST-eindpunt) voor de laatste commit die met de pull request is geassocieerd. De webservice retourneert het aantal toegankelijkheidsproblemen 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 blokkeren van samenvoeging.
Zie De GitHub-actie gebruiken voor meer informatie.