Ändern Sie die Barrierefreiheits-Schwelle (A11y)
Passen Sie an und priorisieren Sie, wie Ihre Organisation Barrierefreiheitsthemen behandelt
A11y ist eine zahlengestützte Abkürzung (oder Numeronym) für das Wort „Barrierefreiheit“, wobei „11“ (elf) die Anzahl der Zeichen zwischen dem Anfangsbuchstaben „b“ und dem Endbuchstaben „f“ in Barrierefreiheit darstellt. Lesen Sie weiter, um mehr über die A11y-Schwelle und die Kriterien zu erfahren, die der Axe Developer Hub für deren Berechnung verwendet.
Was ist die A11y-Schwelle?
Die A11y-Schwelle spiegelt die Toleranz Ihrer Organisation gegenüber Barrierefreiheitsfehlern wider und wird aus zwei Kriterien berechnet:
- Ob die Berechnung alle Barrierefreiheitsprobleme verwendet, die vom Axe Developer Hub während Ihrer Testruns gefunden wurden, oder nur neue Probleme, die im neuesten Testrun entdeckt wurden. (Neue Problemerkennung ist nur für Webprojekte verfügbar. Mobile kommt bald!)
- Welche Auswirkung-Stufen (Kritisch, Schwerwiegend, Moderat und Geringfügig) in die Schwellenwertberechnung einfließen.
Wenn Sie eines der Kriterien für die A11y-Schwelle ändern, nur wirken sich die Änderungen auf zukünftige Berechnungen aus. Ältere A11y-Schwellenwerte werden nicht neu berechnet. Ein Symbol erscheint neben der Berechnung, um anzuzeigen, dass die Konfiguration geändert wurde, und wenn Sie den Mauszeiger darüber bewegen, sehen Sie eine Erinnerung, dass die Schwelle geändert wurde:
Die A11y-Schwelle ermöglicht es Ihnen, den Axe Developer Hub an die Prioritäten Ihrer Organisation anzupassen. Sind neue Probleme das Hauptanliegen Ihrer Organisation oder möchten Sie alle Probleme verfolgen? Welche Auswirkungsstufen sollten priorisiert werden?
Zum Beispiel kann sich der aktuelle Fokus Ihrer Organisation nur auf die Minderung kritischer Probleme konzentrieren, oder Sie möchten beide kritische und schwerwiegende Probleme beheben. Wenn Ihre Organisation gerade erst anfängt, sich mit Barrierefreiheitsproblemen zu befassen, müssen Sie möglicherweise die Auswirkungsstufen, die Sie priorisieren, begrenzen, um nicht überfordert zu werden. Später, wenn das Wissen Ihrer Organisation zur Minderung von Barrierefreiheitsproblemen zunimmt, können Sie die A11y-Schwelle ändern, um Barrierefreiheitsprobleme mit geringerer Auswirkung einzubeziehen.
Wie wird die A11y-Schwelle verwendet?
Die A11y-Schwelle bietet einen schnellen Überblick über die Barrierefreiheitsqualität Ihres Projekts und wird prominent angezeigt, während Sie im Axe Developer Hub tiefergehen, um Probleme zu identifizieren. Jeder Wert über null überschreitet die zulässige Barrierefreiheits-Schwelle und weist auf Probleme hin, die behoben werden müssen. Mit der Zeit können Sie die Barrierefreiheits-Schwelle von Commit zu Commit und von Release zu Release verfolgen, um sich ein Bild über den Barrierefreiheitszustand Ihres Projekts zu machen.
Im untenstehenden Beispiel sehen Sie die berechnete A11y-Schwelle im linken Abschnitt jedes Panels. Hier zeigt der Wert von 2 zwei Probleme an, die die aktuelle Schwelle überschreiten:
Wenn Sie auf den A11y-Schwellenwert klicken - hier 2 - werden die Probleme mit den entsprechenden Auswirkungsstufen dem Filter hinzugefügt, sodass Sie sich nur auf die Probleme konzentrieren können, die die A11y-Schwelle überschritten haben. (In diesem Fall fügt das Klicken auf 2 alle Probleme zum Filter hinzu, da alle in der A11y-Konfiguration festgelegt wurden.)
Konfigurieren der A11y-Schwelle
Nur Administratoren können die Kriterien der A11y-Schwelle ändern. Dadurch wird sie für alle Benutzer des Unternehmens geändert.
Auf Ihrer Axe-Kontoseite klicken Sie auf die Registerkarte KONFIGURATION am oberen Rand der Seite. Auf der Konfigurationsseite wählen Sie Axe Developer Hub aus der Liste auf der linken Seite der Seite aus, um die Konfiguration der A11y-Schwelle anzusehen und zu bearbeiten.
Nachdem Sie Ihre A11y-Schwellenwerteinstellungen geändert haben, klicken Sie auf SPEICHERN.
Enthaltene Probleme
Der Enthaltene Probleme-Wert gibt an, ob bei der Schwellenwertberechnung alle Barrierefreiheitsprobleme, die den ausgewählten Auswirkungen entsprechen, oder nur neue Barrierefreiheitsprobleme berücksichtigt werden. Neu Barrierefreiheitsprobleme sind solche, die bei Ihrem aktuellen Scan erkannt wurden und die im Vergleichsscan nicht gefunden wurden – sei es der vorherige Testrun, das vorherige Commit oder der neueste Scan auf dem Standardzweig. Der angezeigte Wert für die A11y-Schwelle wird auf allen Seiten einheitlich sein, wenn er so eingestellt ist, dass alle Probleme eingeschlossen werden. Wenn er nur auf neue Probleme schaut, kann der Wert je nach Seite variieren, da jede Seite ihren Scan mit einer anderen Basislinie vergleicht.
Hinweis: Die Erkennung neuer Probleme ist nur für Webprojekte verfügbar. Mobile kommt bald.
Eingeschlossene Auswirkungen
Der Eingeschlossene Auswirkungen-Wert gibt an, welche Auswirkungsebene oder -ebenen in die Berechnung einbezogen werden sollen. Probleme mit Kritisch-Auswirkung können nicht abgewählt werden, da diese Probleme Benutzer mit Behinderungen vollständig daran hindern, auf eine Funktion auf einer Webseite oder einer mobilen App zuzugreifen oder damit zu interagieren. Erfahren Sie mehr über alle Auswirkungsebenen.
Verwenden der A11y-Schwelle mit der GitHub-Aktion
Wenn Sie die Axe Developer Hub GitHub-Aktion für Webprojekte verwenden, fungiert die A11y-Schwelle als Türsteher, um Pull-Requests zu blockieren, die Barrierefreiheitsprobleme enthalten. Die Aktion fügt dem Pull-Request einen Kommentar hinzu, der auf das Problem hinweist:
Im obigen Beispiel verweist der Pull-Request-Kommentar auf eine Seite auf der Axe Developer Hub-Website, auf der Sie eine Liste der fehlgeschlagenen Probleme einsehen können. Sie können das Standardverhalten der GitHub Action dahingehend ändern, dass Benutzer nur vor Barrierefreiheitsproblemen gewarnt werden, anstatt die Zusammenführung der Pull-Anfrage zu blockieren.
Wie es funktioniert
Die GitHub Action fragt den Axe Developer Hub-Server (über dessen REST-Endpunkt) nach dem neuesten Commit ab, der mit der Pull-Anfrage verknüpft ist. Der Webservice gibt die Anzahl der Barrierefreiheitsprobleme zurück, die durch die a11y-Schwellenwerteinstellungen bestimmt wurden. Jede Anzahl von Barrierefreiheitsfehlern über null gilt als Fehler, was einen Kommentar zur Pull-Anfrage hinzufügt und sie daran hindern kann, zusammengeführt zu werden.
Siehe Verwendung der GitHub Action für weitere Informationen.