Aan de slag met Axe DevTools CLI
Snelstartgids met de meest voorkomende Axe DevTools CLI-taken
Voordat je begint, installeer Axe DevTools CLI.
Axe DevTools CLI draait via de axe opdracht. Deze handleiding behandelt de drie meest voorkomende taken.
Een Webpagina Analyseren
Geef één of meer URL's direct aan de axe opdracht. Standaard gebruikt de CLI Firefox en voert het de WCAG 2.1 AA regels uit, waarbij de resultaten naar stdout worden geprint:
axe https://example.com/Analyseer meerdere pagina's tegelijk:
axe https://example.com/ https://example.com/about.htmlBewaar resultaten als een JSON-bestand voor later gebruik:
axe https://example.com/ --save=./axe-results.jsonGenereer direct een HTML-rapport:
axe https://example.com/ --report=./axe-reports/Voor alle opties, zie Pagina's Analyseren.
Pagina's Analyseren met een Spec-bestand
Voor meer complexe scenario's, zoals navigeren door een single-page app, inloggen, dialogen sluiten, of een pagina op meerdere punten in een workflow analyseren, gebruik je de axe spec opdracht met een spec-bestand.
Een spec-bestand (JSON of YAML) definieert een lijst van pagina's die geanalyseerd moeten worden en de acties die op elke pagina moeten worden uitgevoerd voor de analyse. Een minimaal voorbeeld (axe-workflow.yaml):
projects:
- name: example
id: example
pageList:
- name: Homepage
url: https://example.com/
- name: Search Results
url: https://example.com/
actions:
- type "axe" into element "#searchform input"
- click element "#searchform button[type=submit]"
- wait for element ".search-results" to be found
- analyzeVoer het uit met axe spec, waarbij je het spec-bestand en een uitvoermap voor de resultaten specificeert:
axe spec ./axe-workflow.yaml ./axe-resultsVoor een volledige referentie van de structuur, acties en opties van spec-bestanden, zie Pagina's Analyseren met een Spec-bestand.
Een Rapport Genereren van Opgeslagen Resultaten
Gebruik de axe reporter opdracht om opgeslagen JSON-resultaten om te zetten naar HTML, JUnit XML, of CSV:
axe reporter ./axe-results --format=htmlGenereer een JUnit XML-rapport (nuttig in CI-pijplijnen):
axe reporter ./axe-results --format=junitGenereer een CSV-rapport:
axe reporter ./axe-results --format=csvVoor filteren en andere opties, zie Rapporten Genereren.
Volgende Stappen
- Pagina's Analyseren: alle opties voor het analyseren van individuele pagina's
- Pagina's Analyseren met een Spec-bestand: spec-bestanden, acties en batchverwerking
- Rapporten Genereren: rapportformaten, filteren, en de structuur van JSON-resultaten
- Naar Axe Reports Verzenden: resultaten uploaden naar de Axe Reports-dienst
- Naar Axe Developer Hub Verzenden: resultaten integreren met de Axe Developer Hub
- Configureren: browserselectie, time-outs en persistente instellingen
- Aangepaste Regels: WCAG 2.x, Sectie 508, en aangepaste regels
