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 viene eseguito 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, la 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, l'accesso, la chiusura dei dialoghi o l'analisi di una pagina in più fasi 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 intraprendere su ciascuna pagina prima di analizzarle. 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 alla struttura dei file spec, azioni e opzioni, vedi Analizza Pagine Usando un File Spec.
Genera un Report dai Risultati Salvati
Utilizza 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 opzioni di filtraggio e altre opzioni, vedi Genera Report.
Prossimi Passi
- Analizza Pagine: tutte le opzioni per analizzare pagine individuali
- Analizza Pagine Usando un File Spec: file spec, azioni e elaborazione batch
- Genera Report: formati di report, filtraggio e struttura dei risultati JSON
- Invia a Axe Reports: caricare i risultati nel servizio Axe Reports
- Invia a Axe Developer Hub: integrare i risultati con Axe Developer Hub
- Configura: selezione del browser, timeout e impostazioni persistenti
- Regole personalizzate: WCAG 2.x, Sezione 508 e set di regole personalizzate
