De toegankelijkheidsresultaten gebruiken met Java

Er zijn vrijwel onbeperkte manieren om de resultaten van een Axe DevTools-scan te benutten

Alle door axe-core aangedreven toegankelijkheidsscans kunnen worden ingesteld om hun resultaten als een JSON-object terug te geven. Dit formaat is eenvoudig te verwerken voor nieuwkomers op het gebied van webtoegankelijkheid, bevat de diepgang van informatie die ervaren materiedeskundigen nodig hebben, en biedt de mogelijkheid om geautomatiseerde rapporten en aangepaste tests te genereren, zelfs buiten een standaard op beweringen gebaseerde teststructuur.

Het resultatenobject genereren

Om het resultatenobject te genereren, zie Rapporten genereren met Java

Overzicht van resultaten

Meta

Het resultatenobject begint met enkele nuttige metainformatie. Dit omvat de naam van de test, het webadres van de geteste pagina, de datum en tijd waarop de test is uitgevoerd, de gebruikte axe-core regels, en meer.

Bevindingen

Het begin van de resultaten wordt gemarkeerd door de „bevindingen“-kop. Er zijn vier soorten resultaten, elk met hun eigen array. Deze resultaatssoorten zijn niet van toepassing, onvolledig, geslaagd, en overtreding. Bovendien bevindt er zich test-specifieke data direct vóór de overtredingenarray.

Niet van toepassing

Niet van toepassing betekent dat er geen paginainhoud relevant was voor die specifieke test, zoals test op formulieren op een pagina zonder formulieren.

Onvolledig

Onvolledigheden zijn tests die zijn uitgevoerd, maar waarvan de resultaten nader onderzoek vereisen om te bepalen in welke categorie de resultaten uiteindelijk zouden moeten vallen. Een veelvoorkomend onvolledig resultaat is kleurcontrastcontrole op elementen met variabele kleurachtergronden waarbij het niet altijd duidelijk is of er voldoende contrast is. Problemen in deze categorie moeten niet automatisch als overtredingen worden behandeld, omdat dat wel of niet het geval kan zijn. Voor gebruikers met meer kennis van toegankelijkheid kan een diepere analyse van deze resultaten helpen om extra overtredingen te ontdekken die niet automatisch getest kunnen worden.

Geslaagd

Deze groep resultaten somt de regels op die zijn gecontroleerd en geen gerelateerde toegankelijkheidsovertredingen hebben gevonden. Aan elke geslaagde regel is een array van pagina-elementen gekoppeld die tegen de regel zijn gecontroleerd en geslaagd.

Overtredingen

De overtredingenarray bevat alle gevonden toegankelijkheidsovertredingen in de scan. Dankzij het zero false positives-beleid van Deque is elk resultaat dat hier wordt gevonden gegarandeerd echt. Elke overtreding bevat verdere informatie over wat de overtreding is, waar deze zich op de pagina bevindt, suggesties om het te verhelpen, en meer. Zie de veldreferentie hieronder voor meer informatie.

Veldreferentie - Geslaagden en Overtredingen

• omschrijving — Tekststring die beschrijft wat de regel doet
• hulp — Hulpptekst die de uitgevoerde test beschrijft
• hulpUrl — URL die meer informatie biedt over de details van de overtreding. Linkt naar een pagina op de Deque University-site.
• id — Unieke identificatie voor de regel; zie de lijst met regels.
• impact — Hoe ernstig de overtreding is. Kan een van de volgende zijn: gering, matig, ernstig, of kritiek als de test is mislukt, of nul als de controle is geslaagd.
• tags — Array van tags die aan deze regel zijn toegewezen. Deze tags kunnen worden gebruikt in de optiestructuur om te selecteren welke regels worden uitgevoerd.
• nodes — Array van alle elementen die door de regel zijn getest
  • html — Fragment HTML van het Element
  • impact — Hoe ernstig de overtreding is. Kan een van de volgende zijn: gering, matig, ernstig, of kritiek als de test is mislukt, of nul als de controle is geslaagd.
  • target — Array van selectoren waarvan elk element overeenkomt met één niveau van iframe of frame. Als er één iframe of frame is, moeten er twee vermeldingen in target zijn. Als er drie iframeniveaus zijn, moeten er vier vermeldingen in target zijn.
  • any — Array van controles die zijn uitgevoerd waarbij ten minste één geslaagd moet zijn. Elke vermelding in de array bevat:
  • id — Unieke identificatie voor deze controle. Controle-id's kunnen hetzelfde zijn als regel-id's
  • impact — Hoe ernstig deze specifieke controle is. Kan een van de volgende zijn: gering, matig, ernstig, of kritiek. Elke controle die deel uitmaakt van een regel kan verschillende impacts hebben. De hoogste impact van alle controles die falen, wordt gerapporteerd voor de regel
  • bericht — Beschrijving waarom deze controle is geslaagd of mislukt
  • gegevens — Aanvullende informatie die specifiek is voor het type controle dat optioneel is. Bijvoorbeeld, een kleurcontrastcontrole zou de voorgrondkleur, achtergrondkleur, contrastverhouding, enz. bevatten.
  • gerelateerdeNodes — Optionele array met informatie over andere knooppunten die gerelateerd zijn aan deze controle. Bijvoorbeeld, een schending van dubbele ID-controle zou de andere selectoren vermelden die dezezelfde dubbele ID hadden. Elke vermelding in de array bevat de volgende informatie:
    • target — Array van selectoren voor het gerelateerde knooppunt
    • html — HTML-bron van het gerelateerde knooppunt
  • all — Array van controles die zijn uitgevoerd waarbij alle geslaagd moeten zijn. Elke vermelding in de array bevat dezelfde informatie als de any array
  • none — Array van controles die zijn uitgevoerd waarbij alle niet geslaagd moeten zijn. Elke vermelding in de array bevat dezelfde informatie als de any array

Resultatengebruik

Deque maakt het makkelijk om de resultaten van uw scans te delen en te verwerken met onze rapportagetool. Deze is configureerbaar om HTML-, JUnit XML- of CSV-rapporten te produceren en geeft, eenmaal ingesteld, automatisch rapporten terug. Zie de handleiding over rapportage om te leren hoe u de rapportagetool instelt en gebruikt.

Daarnaast maakt het JSON-resultatenobject het eenvoudig om je eigen aangepaste tests te schrijven. Naast de standaardtoegankelijkheidsschendingasserties kun je het resultatenobject opdelen naar schendingen, hun ernst, hun impact, hun bijbehorende regels, of een van de andere parameters in het resultatenobject. Alle gegevens die in het resultatenobject worden weergegeven, kunnen dus getest worden.