Inizia con Axe DevTools CLI
Guida rapida che copre le attività più comuni di Axe DevTools CLI
Prima di iniziare, installa Axe DevTools CLI.
Axe DevTools CLI funziona tramite il comando axe . Questa guida copre le tre attività più comuni.
Analizza una Pagina Web
Passa uno o più URL direttamente al comando axe . Per impostazione predefinita, il CLI utilizza Firefox ed esegue il set di regole WCAG 2.1 AA , stampando i risultati su stdout:
axe https://example.com/Analizza più pagine contemporaneamente:
axe https://example.com/ https://example.com/about.htmlSalva i risultati come un file JSON per uso futuro:
axe https://example.com/ --save=./axe-results.jsonGenera un report HTML direttamente:
axe https://example.com/ --report=./axe-reports/Per tutte le opzioni, vedi Analizza Pagine.
Analizza Pagine Usando un File Spec
Per scenari più complessi come la navigazione attraverso un'app a pagina singola, il login, la chiusura di finestre di dialogo o l'analisi di una pagina in più punti di un flusso di lavoro, utilizza il comando axe spec con un file spec.
Un file spec (JSON o YAML) definisce un elenco di pagine da analizzare e le azioni da eseguire su ciascuna pagina prima dell'analisi. Un esempio minimo (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
- analyzeEseguilo con axe spec, specificando il file spec e una directory di output per i risultati:
axe spec ./axe-workflow.yaml ./axe-resultsPer un riferimento completo sulla struttura del file spec, azioni e opzioni, vedi Analizza Pagine Usando un File Spec.
Genera un Report dai Risultati Salvati
Usa il comando axe reporter per convertire i risultati JSON salvati in HTML, JUnit XML o CSV:
axe reporter ./axe-results --format=htmlGenera un report JUnit XML (utile nei pipeline CI):
axe reporter ./axe-results --format=junitGenera un report CSV:
axe reporter ./axe-results --format=csvPer il filtraggio e altre opzioni, vedi Genera Report.
Prossimi Passi
- Analizza Pagine: tutte le opzioni per l'analisi di pagine singole
- Analizza Pagine Usando un File Spec: file spec, azioni e elaborazione batch
- Genera Report: formati report, filtraggio e struttura dei risultati JSON
- Invia a Axe Reports: carica i risultati nel servizio Axe Reports
- Invia a Axe Developer Hub: integra i risultati con Axe Developer Hub
- Configura: selezione del browser, timeout e impostazioni persistenti
- Regole personalizzate: WCAG 2.x, Sezione 508, e regole personalizzate
