Regeln ignorieren
Im Zuge des Wechsels vom Axe DevTools Mobile-Dashboard zum Axe Developer Hub sind die ignoreRules und ignoreExperimental APIs nun veraltet. Wenn Sie die ignoreRules API in Ihren Tests verwendet haben, wird diese weiterhin wie bisher funktionieren. Allerdings wird ignoreExperimental in der Version vom Oktober 2026 entfernt.
Sie können sich entscheiden, bestimmte Regeln bei der Barrierefreiheitstestung zu ignorieren. Wir unterstützen das Ignorieren aller Instanzen einer bestimmten Regel nach Name und das Ignorieren einiger Regeln durch den View-ID-Ressourcennamen. Obwohl wir der Meinung sind, dass alle Regeln wichtig sind, ermöglichen Ihnen diese Anpassungen, Ansichten zu ignorieren, die noch nicht behoben sind, und sich auf das Erkennen neuer Probleme zu konzentrieren.
In den folgenden Beispielen bezieht sich axe auf das AxeDevTools-Objekt, das beim Einloggen initialisiert wird.
Verfügbare APIs
Um eine bestimmte Regel oder Menge von Regeln zu ignorieren, aktualisieren Sie die Konfiguration, bevor die Tests durchgeführt werden.
Regel(n) ignorieren
Der folgende Code zeigt, wie man eine bestimmte Regel ignoriert, TouchSizeWcag.
axe.ignoreRules(mutableListOf("TouchSizeWcag"))Nach View ID-Ressourcennamen ignorieren
Ignorieren Sie ein Set von Regeln mit einem zugewiesenen View ID-Ressourcennamen, indem Sie zwei Parameter verwenden - den Namen der View ID-Ressource und eine Liste der zu ignorierenden Regeln.
axe.ignoreByViewIdResourceName(
"axe_button",
listOf(
"ActiveViewName"
)
)Für Entwickler, die Ansichten mit Jetpack Compose schreiben, empfehlen wir, Modifier.testTag("viewToIgnoreRuleOn") auf der Ansicht zu verwenden, auf die Sie verweisen möchten, anstatt eine View-ID zu verwenden. Außerdem sollten Sie die folgende Semantik-Eigenschaft einem der Vorfahren der Ansicht hinzufügen:
Scaffold(
modifier = Modifier.semantics { testTagsAsResourceId = true }
)Sobald dies geschehen ist, sollten Sie in der Lage sein, Ansichten mit testTag anstelle von viewId in der bestehenden ignoreByViewResourceId-API zu ignorieren.
Beispiel für Composable:
Button(
modifier = Modifier.testTag("<tagToIgnore>"),
onClick = { /* Click action */ }
) {
Text("Click me")
}Experimentelle Regeln ignorieren
Experimentelle Regeln sind Regelsets, die sich noch in der Test- und Entwicklungsphase befinden. Wenn ignoreExperimental aktiviert ist, haben alle Ergebnisse aus den experimentellen Regeln den Status AxeStatus.IGNORED.
axe.ignoreExperimental()Experimentelle Regeln werden eingestellt und ignoreExperimental() wird in der Version vom Oktober 2026 entfernt. Um eine bestimmte Regel auszuschließen, verwenden Sie stattdessen ignore(rule:) (siehe Regeln ignorieren oben).
Ignorierte Regeln zurücksetzen
In Ihrer automatisierten Testumgebung möchten Sie möglicherweise eine neue Testreihe starten und alle Regeln wiederherstellen. In diesem Fall können Sie alle oben festgelegten ignorierten Regeln - mit der resetIgnoredRules-API - löschen.
@Before
fun setup() {
axe.resetIgnoredRules()
}
@Test
fun testButtonOnly() {
axe.ignoreRules(listOf("ScreenTitle"))
...
}
@Test
fun testScreenTitle() {
...
}