Woordenlijst

a11y

Een afkorting voor toegankelijkheid: geïnterpreteerd als de letter a gevolgd door 11 karakters en dan de letter y.

Agora

Agora is Deque's interne artifact-repository. Het is gebaseerd op een Artifactory-instantie. Via Agora kunnen gebruikers Axe DevTools-componenten downloaden, aangepaste regelsets beheren en distribueren, en meer.

ARIA

Accessible Rich Internet Applications (ARIA) is een technische specificatie gepubliceerd door het World Wide Web Consortium, of W3C, die manieren definieert om de toegankelijkheid van webpagina's te vergroten, met name dynamische inhoud en gebruikersinterfacecomponenten ontwikkeld met Ajax, HTML, JavaScript en gerelateerde technologieën.

Hulpmiddelen voor Toegankelijkheid

Sommige gehandicapte personen kunnen mogelijk niet zelfstandig met software en websites omgaan. Deze personen hebben hulpmiddelen voor toegankelijkheid nodig om het internet op een gelijkwaardige manier te gebruiken. Een zeer voorkomende vorm van hulpmiddelen is een schermlezer. Deze apparaten lezen de tekst op het scherm hardop voor voor slechtziende of blinde personen. Er zijn veel verschillende schermlezers, afhankelijk van het platform. Enkele voorbeelden zijn NVDA of JAWS op PC, VoiceOver op Mac, of TalkBack op Android.

Beste Praktijken

Deque's beste praktijken zijn door de tijd bewezen technieken die gewenste toegankelijkheidsresultaten opleveren wanneer specifieke formele methoden ontbreken of onvoldoende zijn. Hoewel ze niet officieel zijn opgenomen in gevestigde toegankelijkheidsregels, kan het volgen van Deque's beste praktijken de toegankelijkheid en de algehele kwaliteit van de geteste webpagina verbeteren. Het is belangrijk op te merken dat het niet naleven van Deque's beste praktijkrichtlijnen niet automatisch een mislukking betekent. Bovendien is deskundig oordeel vereist om de geschiktheid te overwegen in de context van applicatie-, site- of pagina-doelen. Soms is de beste praktijk toegankelijkheidstechniek niet van toepassing of praktisch voor het oplossen van een specifiek probleem. Zie Beste Praktijken voor de regels die de best practices regels set vormen.

Browser Automatiseringsplatform

Voor Axe Watcher is een browser automatiseringsplatform een framework dat je gebruikt om je website-testen te automatiseren. Platforms omvatten Cypress, Playwright, Puppeteer, WebdriverIO en WebDriverJS. Voor meer informatie, zie

• Cypress
• Playwright of Playwright Test
• Puppeteer
• WebdriverIO of WebdriverIO Testrunner
• WebDriverJS

Controlepunt

Een bewezen methode voor het testen van toegankelijkheidseisen, ontwikkeld door het a11y-expertteam van Deque, die de consistentie en nauwkeurigheid van testresultaten verhoogt. Gebaseerd op de WCAG-succescriteria, bieden ze een meer expliciete categorisatie en interpretatie van die richtlijnen, waarbij fouten doorgaans worden gescheiden op inhoudstype. De Deque-controls helpen beoordelaars consistente en nauwkeurige testresultaten te produceren tijdens toegankelijkheidsbeoordelingen. Een controlepunt verwijst naar het meest relevante en toepasbare gedeelte van de hoofdlijst van Deque-controlepunten (en hun vereisten) die een belangrijk onderdeel zijn van de Deque-manier naar digitale gelijkheid.

Component Testing

Met Cypress of Playwright en Axe Watcher kun je individuele componenten (zoals React-componenten) geïsoleerd testen. Dit in tegenstelling tot e2e Testing, dat de gehele webapplicatie test in zijn real-world implementatie. Axe Developer Hub kan toegankelijkheidsproblemen in end-to-end scenario's detecteren en kan componenten geïsoleerd testen met Cypress. Zie e2e Testing.

Configuratieovereenkomst

Een configuratieovereenkomst stelt je in staat om instellingen aan te passen voor specifieke testruns via de (JavaScript/TypeScript) configurationOverrides-eigenschap of (Java) ConfigurationOverrides Klasse in je testconfiguratie. Deze overschrijvingen moeten voldoen aan de wereldwijde configuratie-instellingen van je organisatie en kunnen wijzigingen omvatten aan toegankelijkheidsnormen, beste praktijken, experimentele regels en axe-core versies.

Aangepaste Regelaanpak

Een aangepaste regelset is opgebouwd uit een JSON-bestand met regelgegevens (regels en controles) die aan Axe DevTools-componenten worden doorgegeven om nieuwe regels toe te voegen, de ernst/impact van een regel te wijzigen, of een regel uit de testen te verwijderen.

Duplicaat

Een duplicaat is hetzelfde toegankelijkheidsprobleem dat gezien wordt op hetzelfde document object model (DOM) node in verschillende pagina staten. Als je een probleem met duplicaten oplost, zullen al zijn duplicaten verdwijnen omdat ze allemaal hetzelfde probleem zijn.

e2e Testing

End-to-end, of e2e, testen verwijst naar het testen van de functionaliteit van de gehele webapplicatie door zijn real-world implementatie te testen. Met Axe Developer Hub kun je e2e-scenario's testen op toegankelijkheidsproblemen en individuele componenten geïsoleerd testen met Cypress. Zie ook Component Testing.

Gebeurtenis

Om API- of CLI-gebruik te volgen, creëert de metrische bibliotheek gebeurtenissen en stuurt deze naar de gebruiksdienst. Gebeurtenissen bevatten informatie over het gebruik, zoals het aantal overtredingen van toegankelijkheidsregels tijdens een webpagina-scan en de datum en tijd waarop een toegankelijkheidsscan is voltooid.

Experimentele Regels

Experimentele regels worden nog steeds ontwikkeld en getest om in te spelen op nieuwe technologieën of een beter begrip en bewustzijn van toegankelijkheidskwesties. Op deze regels moet niet vertrouwd worden in productieomgevingen omdat ze nog in ontwikkeling zijn en fout-positieven kunnen opleveren. Uiteindelijk kunnen regels in deze regelset deel gaan uitmaken van toegankelijkheidsstandaarden. Experimentele regels zijn standaard uitgeschakeld. Zie Experimentele Regels voor de regels die deze regelset vormen in de nieuwste versie van axe-core.

Flush

De flush-functie schrijft je Axe Watcher-testresultaten naar de Deque-server en is vereist om ervoor te zorgen dat de resultaten door Axe Developer Hub worden geregistreerd. Je moet de flush-functie in je test suite aanroepen.

Gitless

Gitless verwijst naar het gebruik van het Watcher-pakket met een testsuite die geen gebruik maakt van een Git-repository. Je bent niet verplicht om een Git-repository te gebruiken, maar een Git-repository stelt je in staat om toegankelijkheidsproblemen te koppelen aan specifieke codewijzigingen, wat helpt bij hun oplossing.

Globale Configuratie

Globale configuratie maakt deel uit van Axe Configuratie waarmee je verschillende opties op één plaats kunt instellen om te worden gedeeld tussen verschillende Deque-producten. Je beheerder kan toestaan dat bepaalde instellingen door gebruikers worden gewijzigd.

Identity Token

Een Identity Token is een beveiligingstoken uitgegeven door JFrog waarmee je toegang krijgt tot Deque's Agora-artifactrepository. Identity Tokens moeten bij de aanmaak worden gekopieerd, omdat dit de enige gelegenheid is om ze te benaderen. Ze vervallen na een bepaalde tijdsperiode, meestal één jaar.

Impact

Elke toegankelijkheidsovertreding krijgt een impactniveau toegewezen. Impact is een nuttige maatstaf bij het prioriteren van inspanningen voor herstel. Standaard wordt elk type overtreding toegewezen op een impactniveau door Deque-toegankelijkheidsexperts. Deze waarden zijn algemeen voor de meeste situaties, dus gebruikers mogen hun oordeel gebruiken om ze aan te passen als onderdeel van hun regelsaanaanpassing. Serieuze of kritische impactniveaus correleren met gebruikers met een handicap die aanzienlijke of onoverkomelijke gebruiksbarrières tegenkomen. Deze dragen de grootste mate van juridische aansprakelijkheid. Kleine en matige problemen zijn niet zo ernstig, maar vertegenwoordigen nog steeds belangrijke kwesties voor gebruikers met een handicap en vereisen adressering om ervoor te zorgen dat de pagina volledig voldoet. De volgende vier niveaus worden gebruikt om de impact van gedetecteerde toegankelijkheidskwesties te categoriseren:

• Kritisch: Dit impactniveau betekent dat gebruikers met een handicap volledig worden geblokkeerd voor toegang of interactie met een functie op de webpagina. Totdat een oplossing is geïmplementeerd, zal de inhoud volledig ontoegankelijk zijn. Dit maakt je organisatie zeer kwetsbaar voor rechtszaken. Herstel van kritische problemen moet de hoogste prioriteit hebben.

• Ernstig: Dit impactniveau betekent dat gebruikers met een handicap serieuze barrières zullen ondervinden bij het interactie met de site. Deze gebruikers zullen aanzienlijke frustratie ervaren bij het proberen toegang te krijgen tot gerelateerde inhoud. Totdat een oplossing is geïmplementeerd, zal sommige inhoud moeilijk of onmogelijk toegankelijk zijn, waardoor je organisatie kwetsbaar is voor juridische stappen. Herstel moet een hoge prioriteit zijn.

• Matig: Dit impactniveau betekent dat er enkele barrières bestaan voor gebruikers met een handicap, maar deze zouden hen niet verhinderen om basisstromen of inhoud te benaderen. Problemen met impact op dit niveau kunnen je organisatie kwetsbaar maken voor juridische stappen. Ze vereisen oplossing voordat een pagina volledig voldoet, en moeten worden aangepakt.

• Klein: Een probleem dat minder impact heeft voor gebruikers met een handicap dan een matig probleem. Het probleem kan een lagere prioriteit hebben dan matige, ernstige en kritische problemen, maar vereist nog steeds oplossing om een pagina volledig te laten voldoen.

Onvolledig

Een onvolledig-resultaat betekent dat axe-core niet met volledige zekerheid kon vaststellen of er sprake is van een overtreding, dus moet een mens het inspecteren. Omdat axe-core streeft naar nul fout-positieven, rapporteert het alleen de problemen waarvan het zeker is als overtredingen en registreert het alle onzekerheden apart. Onvolledig en moet worden beoordeeld zijn twee namen voor hetzelfde resultaattype; welke u ziet, hangt af van de Axe DevTools-component die u gebruikt. Een onvolledig resultaat kan wel of niet blijken een toegankelijkheidsprobleem te zijn.

Intelligent Guided Testing (IGT)

Intelligent Guided Testing (IGT) is een interactieve toegankelijkheidstestcomponent van de Axe DevTools-webbrowserextensies die zijn ontworpen om toegankelijkheidsfouten te vinden die niet kunnen worden gedetecteerd in geautomatiseerde testen. IGT stelt de gebruiker eenvoudige vragen over de webpagina die wordt getest en gebruikt deze feedback om meer toegankelijkheidsfouten te lokaliseren dan anders mogelijk zou zijn met geautomatiseerde testen. Om meer te leren over Intelligent Guided Tests, bezoek de Intelligent Guided Tests documentatie.

Probleem

Een schending van toegankelijkheidsrichtlijnen (zoals gedefinieerd door standaarden zoals WCAG 1.0, WCAG 2.0, Section 508 en WAI-ARIA) geïdentificeerd in webpagina- of webapplicatiecode.

JSON Toegankelijkheidsresultaten

Wanneer je een website test op toegankelijkheidsproblemen met behulp van de Axe DevTools API's of CLI, worden je resultaten opgeslagen als een JSON-bestand dat in de documentatie wordt aangeduid als een JSON toegankelijkheidsresultaten-bestand. Je kunt dit bestand uploaden naar Axe Reports (waardoor je de toegankelijkheid van je website in de loop van de tijd kunt monitoren via de Axe Reports-website). Je kunt het JSON-toegankelijkheidsresultatenbestand ook lokaal filteren en converteren naar .csv, .xml of .html met behulp van de CLI. Zie Rapporteren met de CLI voor meer informatie. Alternatief kunnen de API's je ook toelaten om JSON-toegankelijkheidsresultatenbestanden te converteren naar rapporten tijdens een testrun (zie hieronder meer informatie in Rapportage).

Handmatige Modus

Standaard analyseert Axe Developer Hub automatisch elke van je webpagina's en heranalyseert pagina's wanneer het een nieuwe pagina-status detecteert. Je kunt dit automatische gedrag uitschakelen door

• (JavaScript/TypeScript) De autoAnalyze eigenschap instellen op het axe configuratieobject op false.
• (Java) De setAutoAnalyze() methode aanroepen met false.

Je kunt ook het automatische analysegedrag overschrijven door

• (JavaScript/TypeScript) De stop() methode aanroepen.
• (Java) De AxeWatcherController.stop() methode aanroepen.

In beide gevallen plaatst dit Watcher in handmatige modus. In de handmatige modus worden pagina's alleen geanalyseerd wanneer je de analyze() methode aanroept.

Metrics Library

Een interne bibliotheek gebruikt door Deque's API's en CLI om gebruiksinformatie aan de usage service te rapporteren.

Gewijzigde Testsuite

Een gewijzigde testsuite is een testsuite die je hebt gewijzigd volgens de instructies van Axe Developer Hub wanneer je een nieuw project maakte. Door je testsuite te wijzigen kun je toegankelijkheidstesten aan je bestaande testsuite toevoegen met minimale veranderingen aan de testsuite zelf.

Moet worden beoordeeld

Een probleem vereist inspectie door een mens om te bepalen of het probleem daadwerkelijk een overtreding van toegankelijkheidsnormen is. Moet worden beoordeeld betekent hetzelfde als onvolledig: axe-core kon niet met volledige zekerheid vaststellen of het probleem een overtreding is. Als u nieuw bent in toegankelijkheidstesten of werkt aan een site met veel bekende problemen, werk dan eerst de overtredingen af. Wanneer u bij de resultaten die moeten worden beoordeeld bent, raadpleeg dan een digitale toegankelijkheidsexpert voordat u besluit deze te verhelpen of te negeren.

Pagina-status

De pagina-status van een webpagina verwijst naar de status van zijn document object model (DOM) op een specifiek moment. Pagina-statussen zijn nuttig voor complexe websites met inlogschermen of dynamische gebruikersinterfaces zoals single-page applicaties (SPA's). Voorbeelden van DOM-status zijn onder andere:

• De zichtbaarheid van elementen
• De inhoud van elementen
• De geselecteerde staat van radioknoppen en selectievakjes

Het Watcher-pakket scant webpagina's opnieuw wanneer het wijzigingen in de DOM detecteert en slaat elke keer een nieuwe pagina-status op.

Project

Een project in Axe Developer Hub bevat toegankelijkheidsresultaten, testrun-informatie en Git-gegevens (branches en commits). De associatie tussen deze informatie en het project gebeurt via de project-ID van het project. Wanneer je een nieuw project maakt en een naam geeft in Axe Developer Hub, genereert het een project-ID die je gebruikt bij je tests om het project te identificeren.

Rapportage

Rapportage verwijst naar het uploaden van een JSON toegankelijkheidsresultaten-bestand naar Axe Reports of het lokaal converteren naar een rapport (een .csv-, .xml- of .html-bestand) voor gebruik in een andere applicatie.

RGAA

RGAA, of Référentiel Général d'Amélioration de l'Accessibilité, is de webtoegankelijkheidsstandaard van de Franse overheid. Het is grotendeels gebaseerd op WCAG 2.1 en biedt specifieke technische criteria voor het beoordelen van de toegankelijkheid van webinhoud. De huidige ondersteunde versie is RGAA 4, geïdentificeerd door de ruleset-ID rgaav4.

Regel

Een regel komt overeen met een succescriterium van een toegankelijkheidsrichtlijn. Ze worden gedefinieerd door JSON-objectbestanden en bevatten een id, beschrijving en hulpmetadata, evenals een of meer controles en optionele parameters.

Sectie 508

Een amendement op de Rehabilitation Act van de Verenigde Staten van 1973 dat vereist dat federale agentschappen hun elektronische en informatietechnologie toegankelijk maken voor mensen met een handicap. Het omvat zestien bepalingen gebaseerd op toegangsrichtlijnen ontwikkeld door de Web Content Accessibility Guidelines (WCAG) ontwikkeld door het World Wide Web Consortium (W3C), maar zijn niet identiek aan de WCAG 1.0- of 2.0-normen.

SHA

Wanneer je een Git-commit maakt, genereert het een ID die de commit uniek identificeert. De unieke ID wordt een SHA genoemd (een acroniem voor de Secure Hash Algorithms, een groep cryptografische hash-functies).

Gebruik Service

Een REST-webdienst die gebruiksstatistieken registreert voor Axe DevTools voor Web (API's en de CLI). Het is ofwel de openbaar beschikbare dienst aangeboden door Deque of je eigen dienst. Voor meer informatie, zie De Axe DevTools voor Web Gebruiksservice.

Overtreding

Een probleem geïdentificeerd door Axe DevTools dat een of meer toegankelijkheidsstandaarden schendt.

Watcher

Het codecomponent dat je in je testsuite integreert, wordt Watcher genoemd. Deque biedt verschillende edities van het pakket voor de ondersteunde talen en testframeworks. Je integreert het Watcher-pakket in je website testsuite om webpagina's te analyseren en de resultaten naar Axe Developer Hub te rapporteren, waar je de resultaten kunt bekijken. Het Watcher-pakket scant ook de huidige Git-commit en -branch en associeert testruns ermee.

WCAG

WCAG, of Web Content Accessibility Guidelines, zijn ontwikkeld door het World Wide Web Consortium (W3C) en leggen uit hoe webinhoud toegankelijker kan worden gemaakt voor mensen met een handicap. WCAG 1.0 werd gepubliceerd in mei 1999. WCAG 2.0 werd gepubliceerd in december 2008. WCAG 2.0 is breed toepasbaar op geavanceerdere technologieën en is preciezer testbaar met geautomatiseerde testen en menselijke evaluaties. WCAG 2.1 werd gepubliceerd in juni 2018. Deze richtlijnen bevatten succescriteria die testbare criteria definiëren voor specifieke elementen. WCAG 2.2, de meest recente iteratie van de richtlijnen, werd gepubliceerd in 2023 en biedt negen nieuwe succescriteria ten opzichte van WCAG 2.1.

Wrapping

Wrapping verwijst naar het aanpassen van een browserautomatiseringsplatform (zoals Cypress) om toegankelijkheidstestcode (in het Watcher-pakket) aan te roepen wanneer een functie van het browserautomatiseringsplatform wordt aangeroepen. Wrapping stelt je in staat om toegankelijkheidstests te integreren in je bestaande testsuites met minimale aanpassingen aan je code.