Ignorar reglas
Como parte de la transición del panel de Axe DevTools Mobile al Hub de Desarrolladores de Axe, las API ignoreRules y ignoreExperimental ahora están obsoletas. Si has utilizado la API ignoreRules en tus pruebas, esta seguirá funcionando como antes. Sin embargo, ignoreExperimental se eliminará en la versión de octubre de 2026.
Puede elegir ignorar reglas específicas al probar la accesibilidad. Admitimos ignorar todas las instancias de una regla específica por nombre e ignorar algunas reglas por Nombre de Recurso de ID de Vista. Aunque consideramos que todas las reglas son esenciales, estas personalizaciones le permitirán ignorar vistas que aún no se han corregido y centrarse en identificar nuevos problemas.
En los ejemplos a continuación, axe se refiere al objeto AxeDevTools inicializado al iniciar sesión.
APIs disponibles
Para ignorar una regla específica o un conjunto de reglas, actualice la configuración antes de realizar las pruebas.
Ignorar regla(s)
El siguiente código muestra cómo ignorar una regla específica, TouchSizeWcag.
axe.ignoreRules(mutableListOf("TouchSizeWcag"))Ignorar por Nombre de Recurso de ID de Vista
Ignore un conjunto de reglas con un Nombre de Recurso de ID de Vista asignado, usando dos parámetros: el nombre del Recurso de ID de Vista y una lista de reglas a ignorar.
axe.ignoreByViewIdResourceName(
"axe_button",
listOf(
"ActiveViewName"
)
)Para los desarrolladores que están escribiendo vistas utilizando Jetpack Compose, recomendamos usar Modifier.testTag("viewToIgnoreRuleOn") en la vista que desea referenciar en lugar de usar un ID de vista. Además, debe agregar la siguiente propiedad de semántica a uno de los ancestros de la vista:
Scaffold(
modifier = Modifier.semantics { testTagsAsResourceId = true }
)Una vez hecho esto, debería poder ignorar vistas utilizando el testTag en lugar del viewId en la API existente ignoreByViewResourceId.
Ejemplo en Composable:
Button(
modifier = Modifier.testTag("<tagToIgnore>"),
onClick = { /* Click action */ }
) {
Text("Click me")
}Ignorar reglas experimentales
Reglas experimentales son conjuntos de reglas que todavía están en prueba y desarrollo. Cuando ignoreExperimental está habilitado, todos los resultados de las reglas experimentales tendrán el estado de AxeStatus.IGNORED.
axe.ignoreExperimental()Las reglas experimentales se están retirando y ignoreExperimental() se eliminará en la versión de octubre de 2026. Para mantener una regla específica inactiva, utiliza ignore(rule:) en su lugar (ver Ignorar reglas arriba).
Restablecer reglas ignoradas
Dentro de su conjunto automatizado de pruebas, es posible que desee comenzar un nuevo conjunto de pruebas y restaurar las reglas todas. En este caso, puede borrar cualquier regla ignorada que haya configurado utilizando los métodos anteriores, con la API resetIgnoredRules.
@Before
fun setup() {
axe.resetIgnoredRules()
}
@Test
fun testButtonOnly() {
axe.ignoreRules(listOf("ScreenTitle"))
...
}
@Test
fun testScreenTitle() {
...
}