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 regels beheren en verspreiden, 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.

Best Practices

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. Platformen 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. Vergelijk dit met e2e Testing, dat de gehele webapplicatie in zijn real-world implementatie test. Axe Developer Hub kan toegankelijkheidsproblemen in end-to-end scenario's opsporen 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 regelaanpak wordt opgebouwd uit een JSON-bestand dat regelgegevens (regels en controles) bevat, doorgegeven aan axe DevTools-componenten om nieuwe regels toe te voegen, de ernst/impact van een regel te veranderen of een regel uit te sluiten van testen.

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 volledige functionaliteit van de webapplicatie door de real-world implementatie te testen. Met axe Developer Hub kun je e2e scenario's testen op toegankelijkheidsproblemen en kun je 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 worden geregistreerd door het axe Developer Hub. Je moet de flush functie in je testsuite 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.

Intelligent Guided Testing (IGT)

Intelligent Guided Testing (IGT) is een interactieve toegankelijkheidstestcomponent van de axe DevTools-webbrowserextensies, ontworpen om toegankelijkheidsfouten te vinden die niet in geautomatiseerde tests kunnen worden gedetecteerd. IGT stelt de gebruiker eenvoudige vragen over de te testen webpagina en gebruikt deze feedback om meer toegankelijkheidsfouten te lokaliseren dan anders mogelijk zou zijn met geautomatiseerde tests. Voor meer informatie 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 ook het JSON toegankelijkheidsresultatenbestand 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 toestaan om JSON toegankelijkheidsresultatenbestanden tijdens een testrun naar rapporten te converteren (zie Rapporteren hieronder voor meer informatie).

Handmatige Modus

Standaard analyseert axe Developer Hub automatisch elk van je webpagina's en heranalyseert pagina's wanneer het een nieuwe paginastatus 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 aangepast volgens de instructies van axe Developer Hub toen je een nieuw project maakte. Het aanpassen van je testsuite stelt je in staat om toegankelijkheidstests toe te voegen aan je bestaande testsuite met minimale wijzigingen aan de testsuite zelf.

Moet worden beoordeeld

Een probleem moet door een mens worden geïnspecteerd om te bepalen of het daadwerkelijk een schending is van toegankelijkheidsnormen.

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, testuitvoeringinformatie 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 in axe Developer Hub aanmaakt en benoemt, 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 omzetten naar een rapport (.csv, .xml of .html bestand) voor gebruik in een andere toepassing.

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-webservice die gebruiksstatistieken registreert voor axe DevTools for Web (API's en de CLI). Het is ofwel de openbare service die door Deque wordt aangeboden of je eigen service. Voor meer informatie, zie De axe DevTools for Web Usage Service.

Overtreding

Een probleem geïdentificeerd door axe DevTools dat één 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 te rapporteren aan axe Developer Hub, waar je de resultaten kunt bekijken. Het Watcher-pakket scant ook de huidige Git-commit en -branch en associeert testuitvoeringen 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.