Esportazione da axe Developer Hub
Quali informazioni è possibile esportare da axe Developer Hub?
Questo articolo spiega come esportare i tuoi errori di accessibilità da axe Developer Hub per utilizzarli altrove. Puoi esportare i tuoi errori in formato JSON o CSV.
Esportazione
Dalla pagina degli errori di axe Developer Hub, puoi esportare i errori del tuo test in formato CSV o JSON.
Esempi di esportazione
Per i dati di esportazione di esempio in questo articolo, c'è un errore di accessibilità nell'HTML di origine: nella pagina web mancava l'attributo lang nell'elemento html , utilizzava <html>
instead of <html lang="en">
.
Esempio CSV
La prima riga del file CSV indica i nomi delle colonne.
Ogni valore di colonna è racchiuso tra virgolette perché alcune colonne (ad esempio Tags) possono contenere virgole.
Le colonne Descrizione, Guida alle regole e Riepilogo possono contenere tag HTML, pertanto il loro contenuto deve essere sottoposto a escape prima di essere incluso in una pagina Web.
"Rule ID","Description","Rule Help","Help URL","Impact","Element Location","Element Source Code","Page State","Summary","Tags","Created At"
"html-has-lang","Ensures every HTML document has a lang attribute","<html> element must have a lang attribute","https://dequeuniversity.com/rules/axe/4.6/html-has-lang?application=axeAPI","serious","html","<html>","http://localhost:3000/index.html","Fix any of the following:
The <html> element does not have a lang attribute","cat.language,wcag2a,wcag311,ACT","2023-03-20T17:43:17.204Z"
Per informazioni sulle colonne CSV, vedere Spiegazione delle colonne CSV e delle proprietà JSON di seguito.
Esempio JSON
Per lo stesso lang attributo mancante, il JSON esportato appare come segue:
[
{
"id": "html-has-lang",
"impact": "serious",
"tags": [
"cat.language",
"wcag2a",
"wcag311",
"ACT"
],
"description": "Ensures every HTML document has a lang attribute",
"help": "<html> element must have a lang attribute",
"helpUrl": "https://dequeuniversity.com/rules/axe/4.6/html-has-lang?application=axeAPI",
"nodes": [
{
"page_state": "http://localhost:3000/index.html",
"created_at": "2023-03-20T17:43:17.204Z",
"html": "<html>",
"target": [
"html"
],
"failureSummary": "Fix any of the following:\n The <html> element does not have a lang attribute"
}
]
}
]
Per informazioni sulle proprietà JSON nel file JSON di esportazione, vedere la sezione successiva.
Spiegazione delle colonne CSV e delle proprietà JSON
Nella tabella seguente vengono spiegate le colonne CSV e le proprietà JSON. Ci sono diversi oggetti incorporati nel JSON:
- tags, un array di stringhe che rappresentano ogni tag
- nodi, un array di oggetti nodi
- nodo, un oggetto che rappresenta informazioni su ogni errore di accessibilità
Nella tabella sottostante, l'oggetto nodo e le proprietà in esso contenute sono rappresentati come nodo.nome-proprietà.
Nome colonna CSV | Proprietà JSON | Descrizione |
---|---|---|
ID regola | id | Nome della regola axe-core. Vedi Descrizioni delle regole axe-core per maggiori informazioni sulle regole di axe-core. |
Descrizione | descrizione | Descrizione del difetto di accessibilità |
Guida alla regola | aiuto | Informazioni su come correggere il difetto di accessibilità |
URL di aiuto | helpUrl | Collegamento alle informazioni su Deque University riguardo a questo difetto di accessibilità |
Impatto | impatto | Gravità del difetto: minore, moderata, grave o critica |
Posizione dell'elemento | nodo.target (array) | Selettore CSS per la posizione dell'errore |
Codice sorgente dell'elemento | nodo.html | HTML di origine per l'errore |
Stato della pagina | nodo.page_state | URL della pagina contenente l'errore |
Sommario | node.failureSummary | Descrizione della correzione per questo errore |
Etichette | node.tags (array) | Tag a cui appartiene questa regola. Consulta Descrizioni delle regole di axe-core per maggiori informazioni sulle etichette di axe-core. |
Creato il | nodo.creato_il | Data e ora in cui è stato rilevato questo errore (nel formato ISO 8601, fuso orario UTC) |