Regeln ignorieren
Im Rahmen des Übergangs vom Axe DevTools Mobile-Dashboard zum Axe Developer Hub sind die ignore(rule)- und ignoreExperimental-APIs jetzt veraltet. Wenn Sie die ignore(rule)-API in Ihren Tests verwendet haben, wird diese weiterhin wie zuvor funktionieren. ignoreExperimental wird in der Veröffentlichung im Oktober 2026 entfernt.
Sie können wählen, bestimmte Regeln zu ignorieren, während Sie auf Barrierefreiheit testen. Wir unterstützen das Ignorieren einer spezifischen Regel, das Ignorieren von Regeln nach Klassenname und das Ignorieren von Regeln nach Zugänglichkeitskennzeichen. Auch wenn wir der Meinung sind, dass alle Regeln wichtig sind, ermöglichen Ihnen diese Anpassungen, Ansichten zu ignorieren, die noch behoben werden müssen, und sich auf die Identifizierung neuer Probleme zu konzentrieren.
In den folgenden Beispielen bezieht sich axe auf das beim Einloggen initialisierte AxeDevTools Objekt.
Verfügbare APIs
Um eine spezifische Regel oder eine Gruppe von Regeln zu ignorieren, aktualisieren Sie die Konfiguration, bevor die Tests durchgeführt werden.
Regeln ignorieren
Der untenstehende Code zeigt, wie man eine spezifische Regel ignoriert, ConflictingTraits.
Regeln, die mit dieser API ignoriert werden, werden nicht ausgeführt und sind daher im Dashboard nicht verfügbar.
axe?.configuration.ignore(rule: AxeRuleId.ConflictingTraits.toString())Um mehrere Regeln zu ignorieren, erstellen Sie ein Array der Regeln, getrennt durch Kommas:
axe?.configuration.ignore(rules: [AxeRuleId.ConflictingTraits.toString(), AxeRuleId.InScrollView.toString()])Regeln nach Klassenname ignorieren
Regeln, die mit dieser API ignoriert werden, werden ausgeführt und im Dashboard unter dem Status IGNORED gemeldet.
axe?.configuration.ignore(rulesFor: ["UILabel": [AxeRuleId.InScrollView.toString()]])Regeln nach Zugänglichkeitskennzeichen ignorieren
Regeln, die mit dieser API ignoriert werden, werden ausgeführt und im Dashboard unter dem Status IGNORED gemeldet.
axe?.configuration.ignore(rulesFor: ["LoginScreen.Button": [AxeRuleId.CollidingViews.toString()]])Hinweis: Der Parameter rulesFor unterstützt Klassennamen und Zugänglichkeitskennzeichen.
Experimentelle Regeln ignorieren
Experimentelle Regeln sind Regelsätze, die sich noch in der Test- und Entwicklungsphase befinden. Ergebnisse für die experimentellen Regeln können mit der Methode ignoreExperimental IGNORED werden, und so werden sie nicht ausgeführt.
Experimentelle Regeln werden eingestellt und ignoreExperimental() wird in der Oktober 2026-Version entfernt. Um eine bestimmte Regel deaktiviert zu lassen, verwenden Sie stattdessen ignore(rule:) (siehe Regeln ignorieren oben).
axe?.configuration.ignoreExperimental()Regeln mit automatisierten Tests ignorieren
Um Regeln während der Durchführung von Unit- oder UI-Tests zu ignorieren, aktualisieren Sie die Konfiguration, bevor Ihre Tests ausgeführt werden. Wir empfehlen, die Methoden setUp und tearDown zu nutzen.