Regels negeren
U kunt ervoor kiezen om bepaalde regels te negeren tijdens het testen van toegankelijkheid. Wij ondersteunen het negeren van alle gevallen van een specifieke regel bij naam en het negeren van sommige regels op basis van de View ID Resource Name. Hoewel wij van mening zijn dat alle regels essentieel zijn, stellen deze aanpassingen u in staat om weergaven die nog moeten worden gecorrigeerd over te slaan en te focussen op het identificeren van nieuwe problemen.
In de onderstaande voorbeelden, axe verwijst naar het AxeDevTools object dat wordt geïnitialiseerd bij het inloggen.
Beschikbare API's
Om een specifieke regel of set van regels te negeren, werkt u de configuratie bij voordat het testen plaatsvindt.
Regel(s) negeren
De onderstaande code laat zien hoe u een specifieke regel kunt negeren, TouchSizeWcag.
axe.ignoreRules(mutableListOf("TouchSizeWcag"))Negeren op basis van View ID Resource Name
Negeren van een set regels met een toegewezen View ID Resource Name, waarbij twee parameters worden gebruikt - de naam van de View ID Resource en een lijst van regels om te negeren.
axe.ignoreByViewIdResourceName(
"axe_button",
listOf(
"ActiveViewName"
)
)Voor ontwikkelaars die weergaven schrijven met Jetpack Compose, raden we aan om Modifier.testTag("viewToIgnoreRuleOn") te gebruiken op de weergave die u wilt refereren in plaats van een view-ID te gebruiken. Daarnaast moet u de volgende semantische eigenschap toevoegen aan een van de voorouders van de weergave:
Scaffold(
modifier = Modifier.semantics { testTagsAsResourceId = true }
)Zodra dat is gedaan, zou u weergaven moeten kunnen negeren met behulp van de testTag in plaats van de viewId in de bestaande ignoreByViewResourceId API.
Voorbeeld op Composable:
Button(
modifier = Modifier.testTag("<tagToIgnore>"),
onClick = { /* Click action */ }
) {
Text("Click me")
}Experimentele regels negeren
Experimentele regels zijn regels die nog in ontwikkeling en testfase zijn. Wanneer ignoreExperimental is ingeschakeld, zullen alle resultaten van de experimentele regels de status hebben van AxeStatus.IGNORED.
axe.ignoreExperimental()Genegeerde regels resetten
Binnen uw geautomatiseerde testsuite wilt u misschien een nieuwe set tests starten en alle regels herstellen. In dit geval kunt u eventuele genegeerde regels die u hebt ingesteld met behulp van de bovenstaande methoden wissen - met de resetIgnoredRules API.
@Before
fun setup() {
axe.resetIgnoredRules()
}
@Test
fun testButtonOnly() {
axe.ignoreRules(listOf("ScreenTitle"))
...
}
@Test
fun testScreenTitle() {
...
}