Exportieren aus dem axe Developer Hub
Welche Informationen können Sie aus dem axe Developer Hub exportieren?
In diesem Artikel wird erläutert, wie Sie Ihre Zugänglichkeitsprobleme aus dem axe Developer Hub exportieren, um sie anderswo zu verwenden. Sie können Ihre Fehler entweder als JSON oder CSV exportieren.
Exportieren
Von der Fehlerseite des axe Developer Hub können Sie die Fehler Ihres Testlaufs im CSV- oder JSON-Format exportieren.
Exportbeispiele
Für die Beispiel-Exportdaten in diesem Artikel liegt im HTML-Quelltext ein Barrierefreiheitsfehler vor: Auf der Webseite fehlte das Attribut lang im Element html ; es wurde „ <html> instead of ```“ verwendet.
CSV-Beispiel
Die erste Zeile der CSV-Datei gibt die Spaltennamen an.
Jeder Spaltenwert ist in Anführungszeichen eingeschlossen, da einige Spalten (wie Tags) Kommas enthalten können.
Die Spalten Beschreibung, Regelhilfe und Zusammenfassung können HTML-Tags enthalten. Daher muss ihr Inhalt maskiert werden, bevor er in eine Webseite eingefügt wird.
"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"Informationen zu den CSV-Spalten finden Sie weiter unten unter Erläuterung der CSV-Spalten und der JSON-Eigenschaften .
JSON-Beispiel
Für dasselbe fehlende lang -Attribut sieht das exportierte JSON wie folgt aus:
[
{
"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"
}
]
}
]Informationen zu den JSON-Eigenschaften im Export-JSON finden Sie im nächsten Abschnitt.
Erklärung der CSV-Spalten und der JSON-Eigenschaften
In der folgenden Tabelle werden die CSV-Spalten und JSON-Eigenschaften erläutert. Im JSON sind mehrere Objekte eingebettet:
- tags, ein Array von Zeichenfolgen, die jedes tag darstellen
- nodes, ein Array von node Objekten
- node, ein Objekt, das Informationen zu jedem Zugänglichkeitsfehler darstellt
Für die folgende Tabelle werden das node -Objekt und seine enthaltenen Eigenschaften als node.Eigenschaftsname dargestellt.
| CSV-Spaltenname | JSON-Eigenschaft | Beschreibung |
|---|---|---|
| Regel-ID | id | Der Name der axe-core-Regel. Weitere Informationen zu den axe-core-Regeln finden Sie unter axe-core-Regelbeschreibungen . |
| Beschreibung | Beschreibung | Beschreibung des Barrierefreiheitsmangels |
| Regelhilfe | Hilfe | Informationen zur Behebung des Barrierefreiheitsmangels |
| Hilfe-URL | helpUrl | Link zu Informationen auf der Deque University zu diesem Barrierefreiheitsdefekt |
| Auswirkung | Einfluss | Schwere des Defekts: geringfügig, mittelschwer, schwerwiegend oder kritisch |
| Position des Elements | node.target (Array) | CSS-Selektor für den Fehlerort |
| Quellcode des Elements | node.html | Quell-HTML für den Fehler |
| Seitenstatus | node.page_state | URL der Seite, die den Fehler enthält |
| Zusammenfassung | node.failureSummary | Beschreibung der Lösung für diesen Fehler |
| Tags | node.tags (array) | Tags, zu denen diese Regel gehört. Weitere Informationen zu den Tags von axe-core finden Sie unter axe-core-Tagbeschreibungen . |
| Erstellt am | node.erstellt_at | Datum und Uhrzeit der Erkennung dieses Fehlers (im ISO 8601-Format, UTC-Zeitzone) |