Ändern der Zugänglichkeitsschwelle (A11y)
So ändern Sie den a11y-Schwellenwert, um die Art und Weise anzupassen, wie Ihre Organisation mit Barrierefreiheitsproblemen umgeht
In diesem Artikel wird die Barrierefreiheitsschwelle (a11y) erläutert. Außerdem erfahren Sie, wie Sie die Kriterien ändern können, die der axe Developer Hub zur Berechnung des a11y-Schwellenwerts verwendet.
Was ist die A11y-Schwelle?
Der a11y-Schwellenwert spiegelt die Toleranz Ihrer Organisation gegenüber Barrierefreiheitsfehlern wider und ist eine Zahl, die aus zwei Kriterien berechnet wird:
- Ob bei der Berechnung ** alle ** Zugänglichkeitsprobleme berücksichtigt werden, die vom axe Developer Hub während Ihrer Testläufe gefunden wurden, oder nur neue Probleme, die beim letzten Testlauf entdeckt wurden.
- Welche Auswirkungen (kritisch, schwerwiegend, mittelschwer und geringfügig) werden in die Schwellenwertberechnung einbezogen.
Wenn Sie eines der Kriterien für den a11y-Schwellenwert ändern, wirkt sich die Änderung nur auf zukünftige Berechnungen aus, nicht jedoch auf vergangene Berechnungen. Ältere a11y-Schwellenwerte werden nicht neu berechnet. Neben der Berechnung wird ein Symbol angezeigt, das darauf hinweist, dass sich die Konfiguration geändert hat. Wenn Sie mit der Maus darüber fahren, werden Sie daran erinnert, dass sich der Schwellenwert geändert hat:
Mit dem a11y-Schwellenwert können Sie den axe Developer Hub an die Dinge anpassen, die für Ihr Unternehmen wichtig sind:
- Sind neue Probleme das Hauptanliegen Ihrer Organisation oder möchten Sie alle Probleme verfolgen?
– Welche Auswirkungen sind für Ihre Organisation wichtig?
Vielleicht sind Sie beispielsweise nur an der Eindämmung kritischer Probleme interessiert, oder vielleicht möchten Sie nur sowohl kritische als auch schwerwiegende Probleme ansprechen. Vielleicht steht Ihre Organisation noch ganz am Anfang bei der Behandlung von Barrierefreiheitsproblemen und Sie müssen die Auswirkungen begrenzen, um eine Überforderung zu vermeiden. Wenn sich das Wissen Ihrer Organisation zur Bekämpfung von Barrierefreiheitsproblemen weiterentwickelt, können Sie später schwerwiegende (oder moderate bzw. geringfügige) Auswirkungen hinzufügen.
Wie wird der A11y-Schwellenwert verwendet?
Der a11y-Schwellenwert bietet eine schnelle Einschätzung der Zugänglichkeitsqualität Ihres Projekts und wird überall auf der axe Developer Hub-Site deutlich sichtbar angezeigt. Jeder Wert über Null überschreitet den zulässigen Zugänglichkeitsschwellenwert und weist auf Probleme hin, die behoben werden müssen. Im Laufe der Zeit können Sie den Zugänglichkeitsschwellenwert von Commit zu Commit und von Release zu Release verfolgen, um sich ein Bild über den Zugänglichkeitszustand Ihres Projekts zu machen.
Auf den folgenden Seiten ist der a11y-Grenzwert dargestellt:
Das folgende Beispiel zeigt, wie der berechnete a11y-Schwellenwert im linken Abschnitt jedes Fensters angezeigt wird (hier gibt es zwei Probleme über dem Schwellenwert):
Wenn Sie auf den a11y-Schwellenwert (hier 2) klicken, werden die Auswirkungen zum Filter hinzugefügt. So können Sie gezielt nur die Probleme anzeigen, die zur Überschreitung des a11y-Schwellenwerts geführt haben. (In diesem Fall wurden durch Klicken auf 2 alle Effekte zum Filter hinzugefügt, da alle in der a11y Konfiguration festgelegt wurden.)
Wie man ändert
Auf Ihrer axe-Kontoseite Klicken Sie oben auf der Seite auf die Registerkarte KONFIGURATION:
Sie sehen die Konfigurationsseite. Wählen Sie axe Developer Hub aus der Liste auf der linken Seite, um die a11y-Schwellenwertkonfiguration anzuzeigen:
Einzelkontoinhaber können die a11y-Schwellenwertkriterien ändern. Wenn Sie jedoch Teil eines Unternehmens sind, müssen Sie Unternehmensadministrator sein, um sie ändern zu können.
Wenn Sie als Unternehmensadministrator den a11y-Schwellenwert ändern, wird er für alle Benutzer des Unternehmens geändert.
Nachdem Sie Ihre a11y-Schwellenwerteinstellungen geändert haben, klicken Sie auf SPEICHERN.
Sie können Kritisch nicht aus der Liste der Auswirkungen deaktivieren, da kritische Probleme dazu führen, dass Inhalte für Menschen mit Behinderungen blockiert werden und diese dadurch nicht auf grundlegende Funktionen oder Inhalte zugreifen können.
Enthaltene Probleme
Der Wert Enthaltene Probleme gibt an, ob in die Schwellenwertberechnung einbezogen werden soll
- alle Zugänglichkeitsprobleme, die den ausgewählten Auswirkungen entsprechen oder
- nur die neuen .
Berücksichtigte Auswirkungen
Der Wert Einbezogene Auswirkungen gibt an, welche Auswirkungsstufe(n) in die Berechnung einbezogen werden sollen.
In der vorliegenden Implementierung sind die a11y-Schwellenwerteinstellungen vollständig unabhängig von den globalen Zugänglichkeitseinstellungen (auf der Registerkarte Global auf der Seite Konfiguration ) (dies kann sich jedoch in Zukunft ändern). Durch Ändern der Einstellungen auf der Registerkarte Global wird die Zugänglichkeitsschwelle nicht geändert (oder umgekehrt).
Verwenden der Zugänglichkeitsschwelle mit der GitHub-Aktion
Sie können die Zugänglichkeitsschwelle mit der GitHub-Aktion „axe Developer Hub“ verwenden, um als Gatekeeper zu fungieren und Pull Requests mit Zugänglichkeitsproblemen, die die Zugänglichkeitsschwelle überschreiten, standardmäßig zu blockieren. Die Aktion fügt dem Pull Request einen Kommentar hinzu, der das Problem angibt:
Im obigen Beispiel-Pull Request-Kommentar leitet Sie der Link zur Seite Probleme auf der Website des axe Developer Hub weiter, um die Probleme anzuzeigen, die bei diesem Pull Request fehlgeschlagen sind. Sie können das Standardverhalten auch so ändern, dass Benutzer nur vor Barrierefreiheitsproblemen gewarnt werden, anstatt die Zusammenführung des Pull Request zu blockieren.
Wie es funktioniert
Die GitHub-Aktion fragt den Server des Axe Developer Hub (über seinen REST-Endpunkt) nach dem neuesten Commit ab, das mit diesem Pull Request verknüpft ist. Der Webdienst gibt die Anzahl der Zugänglichkeitsprobleme zurück, die durch die a11y-Schwellenwerteinstellungen bestimmt wurden. Standardmäßig wird jede Anzahl von Barrierefreiheitsfehlern über Null als Fehler betrachtet, was dazu führt, dass ein Kommentar wie der oben genannte dem Pull Request hinzugefügt wird und das Zusammenführen des Pull Request blockiert wird.
Weitere Informationen finden Sie unter Verwenden der GitHub-Aktion .