Verwendung der Barrierefreiheitsergebnisse in Java

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Informationen zum Format der Barrierefreiheitsergebnisse

Not for use with personal data

Es gibt praktisch unbegrenzte Möglichkeiten, die Ergebnisse eines axe DevTools-Scans zu nutzen

Alle von Axe-Core gesteuerten Barrierefreiheitsscans können so eingerichtet werden, dass sie als JSON-Objekt zurückgegeben werden. Dieses Format ist für Neulinge im Bereich der Barrierefreiheit im Internet leicht zu verwenden, enthält die Informationen, die erfahrene Fachexperten benötigen, und ermöglicht die automatische Berichterstellung und benutzerdefinierte Tests auch außerhalb eines standardmäßigen, auf Behauptungen basierenden Testformats.

Generieren des Ergebnisobjekts

Informationen zum Generieren des Ergebnisobjekts finden Sie unter Berichte mit Java generieren

Ergebnisübersicht

Ergebnisse

Den Anfang der Ergebnisse markiert die Überschrift „Befunde“. Es gibt vier Ergebnistypen, jeder mit seinem eigenen Array. Diese Ergebnistypen sind nicht zutreffend, unvollständig, bestanden und Verletzung. Darüber hinaus gibt es einige testspezifische Daten, die sich unmittelbar vor dem Verstoß-Array befinden.

Nicht anwendbar

Nicht zutreffend bedeutet, dass für den jeweiligen Test kein relevanter Seiteninhalt vorhanden war, wie z. B. formularbezogene Tests auf einer Seite ohne Formulare.

Unvollständig

Unvollständig sind Tests, die ausgeführt wurden, deren Ergebnisse jedoch einer weiteren Überprüfung bedürfen, um zu bestimmen, in welche Kategorie die Ergebnisse letztendlich einzuordnen sind. Eine häufige unvollständige Besetzung ist die Überprüfung des Farbkontrasts bei Elementen mit unterschiedlich farbigen Hintergründen, bei denen nicht immer klar ist, ob ausreichend Kontrast vorhanden ist. Probleme in dieser Kategorie sollten nicht automatisch als Verstöße behandelt werden, da sie es möglicherweise sind oder nicht. Für Benutzer mit umfassenderen Kenntnissen im Bereich Barrierefreiheit kann eine eingehendere Untersuchung dieser Ergebnisse dabei helfen, zusätzliche Verstöße zu erkennen, die nicht automatisch geprüft werden können.

Bestanden

Diese Ergebnisgruppe listet die Regeln auf, bei denen keine entsprechenden Verstöße gegen die Barrierefreiheit festgestellt wurden. Mit jeder bestandenen Regel ist ein Array von Seitenelementen verknüpft, die auf Übereinstimmung mit der Regel geprüft und bestanden wurden.

Verstöße

Das Array „Verstöße“ enthält alle beim Scannen festgestellten Zugänglichkeitsverstöße. Dank Deques Null-Falschpositive-Richtlinie ist jedes hier gefundene Ergebnis garantiert echt. Zu jedem Verstoß gibt es weitere Informationen dazu, worin der Verstoß besteht, wo auf der Seite er sich befindet, Vorschläge zur Behebung des Verstoßes und mehr. Weitere Informationen finden Sie in der Feldreferenz weiter unten.

Feldreferenz - Erfolge und Verstöße

Beschreibung: Textzeichenfolge, die beschreibt, was die Regel bewirkt.
Hilfe — Hilfetext, der den durchgeführten Test beschreibt
helpUrl – URL, die weitere Informationen zu den Einzelheiten des Verstoßes bereitstellt. Links zu einer Seite auf der Website der Deque University.
id – Eindeutige Kennung für die Regel, siehe Liste der Regeln.
Auswirkung – Wie schwerwiegend die Verletzung ist. Kann geringfügig, mittelschwer, schwerwiegend oder kritisch sein, wenn der Test fehlgeschlagen ist, oder null, wenn die Prüfung erfolgreich war.
Tags – Array von Tags, die dieser Regel zugewiesen sind. Diese Tags können in der Optionsstruktur verwendet werden, um auszuwählen, welche Regeln ausgeführt werden.
Knoten — Array aller Elemente, die geprüft wurden
- html — HTML-Ausschnitt des Elements
- Auswirkung – Wie schwerwiegend die Verletzung ist. Kann geringfügig, mittelschwer, schwerwiegend oder kritisch sein, wenn der Test fehlgeschlagen ist, oder null, wenn die Prüfung erfolgreich war.
- target — Array von Selektoren, bei dem jedes Element einer Iframe- oder Frame-Ebene entspricht. Wenn ein Iframe oder Frame vorhanden ist, sollten im target zwei Einträge vorhanden sein. Wenn drei Iframe-Ebenen vorhanden sind, sollten im Ziel vier Einträge vorhanden sein.
- any – Array von durchgeführten Checks, von denen mindestens einer erfolgreich gewesen sein muss. Jeder Eintrag im Array enthält:
- id – Eindeutige Kennung für diesen Check. Prüf-IDs können mit Regel-IDs identisch sein.
- Auswirkung – Wie schwerwiegend diese bestimmte Prüfung ist. Kann entweder geringfügig, mäßig, schwerwiegend oder kritisch sein. Jede Prüfung, die Teil einer Regel ist, kann unterschiedliche Auswirkungen haben. Die schwerwiegendste Auswirkung aller fehlgeschlagenen Prüfungen wird für die Regel gemeldet.
- Nachricht – Beschreibung, warum diese Prüfung erfolgreich war oder fehlgeschlagen ist
- Daten – Zusätzliche Informationen, die für die Art des Checks spezifisch und optional sind. Eine Farbkontrastprüfung würde beispielsweise die Vordergrundfarbe, die Hintergrundfarbe, das Kontrastverhältnis usw. umfassen.
- relatedNodes – Optionales Array mit Informationen zu anderen Knoten, die mit diesem Check in Zusammenhang stehen. Beispielsweise würde ein Verstoß gegen den Check auf doppelte IDs zu einer Auflistung der anderen Selektoren führen, die dieselbe doppelte ID aufweisen. Jeder Eintrag im Array enthält die folgenden Informationen:
  - target — Array von Selektoren für den zugehörigen Knoten
  - html — HTML-Quelle des zugehörigen Knotens
- all – Array von durchgeführten Prüfungen, bei denen alle erfolgreich gewesen sein müssen. Jeder Eintrag im Array enthält die gleichen Informationen wie das any Array
- none – Array von durchgeführten Prüfungen, von denen keine erfolgreich gewesen sein darf. Jeder Eintrag im Array enthält die gleichen Informationen wie das any Array

Ergebnisverwendung

Deque erleichtert Ihnen die Weitergabe und Auswertung der Scan-Ergebnisse an unser Berichtswerkzeug. Es lässt sich für die Erstellung von HTML-, JUnit-XML- oder CSV-Berichten konfigurieren und gibt nach der Einrichtung automatisch Berichte zurück. Im Leitfaden zum Reporting finden Sie Informationen zum Einrichten und Verwenden des Reporters.

Darüber hinaus erleichtert das JSON-Ergebnisobjekt das Schreiben eigener benutzerdefinierter Tests. Über die standardmäßigen Aussagen zu Barrierefreiheitsverletzungen hinaus können Sie das Ergebnisobjekt nach Verletzungen, deren Schweregrad, deren Auswirkung, dem zugehörigen Regelsatz oder einem der Parameter im Ergebnisobjekt unterteilen. Daher können alle im Ergebnisobjekt enthaltenen Daten getestet werden.