Ignorer des règles
Dans le cadre de la transition du tableau de bord Axe DevTools Mobile vers Axe Developer Hub, les API ignoreRules et ignoreExperimental sont maintenant obsolètes. Si vous avez utilisé l'API ignoreRules dans vos tests, elle fonctionnera encore comme avant. Cependant, ignoreExperimental sera supprimée dans la version d'octobre 2026.
Vous pouvez choisir d'ignorer des règles spécifiques lors des tests d'accessibilité. Nous vous permettons d'ignorer toutes les instances d'une règle spécifique par nom et d'ignorer certaines règles par le nom de ressource View ID. Bien que nous estimions que toutes les règles sont essentielles, ces personnalisations vous permettront d'ignorer les vues qui n'ont pas encore été corrigées et de vous concentrer sur l'identification de nouveaux problèmes.
Dans les exemples ci-dessous, axe fait référence à l'objet AxeDevTools initialisé lors de la connexion.
APIs Disponibles
Pour ignorer une règle spécifique ou un ensemble de règles, mettez à jour la configuration avant que les tests ne commencent.
Ignorer Règle(s)
Le code ci-dessous montre comment ignorer une règle spécifique, TouchSizeWcag.
axe.ignoreRules(mutableListOf("TouchSizeWcag"))Ignorer par Nom de Ressource View ID
Ignorez un ensemble de règles avec un nom de ressource View ID assigné, en utilisant deux paramètres - le nom de la ressource View ID et une liste de règles à ignorer.
axe.ignoreByViewIdResourceName(
"axe_button",
listOf(
"ActiveViewName"
)
)Pour les développeurs qui écrivent des vues en utilisant Jetpack Compose, nous recommandons d'utiliser Modifier.testTag("viewToIgnoreRuleOn") sur la vue que vous souhaitez référencer plutôt que d'utiliser un ID de vue. De plus, vous devriez ajouter la propriété sémantique suivante à l'un des ancêtres de la vue :
Scaffold(
modifier = Modifier.semantics { testTagsAsResourceId = true }
)Une fois cela fait, vous devriez pouvoir ignorer les vues en utilisant le testTag à la place du viewId dans l'API existante ignoreByViewResourceId.
Exemple sur Composable :
Button(
modifier = Modifier.testTag("<tagToIgnore>"),
onClick = { /* Click action */ }
) {
Text("Click me")
}Ignorer les Règles Expérimentales
Les règles expérimentales sont des ensembles de règles qui sont encore en phase de test et de développement. Lorsque ignoreExperimental est activé, tous les résultats des règles expérimentales auront le statut de AxeStatus.IGNORED.
axe.ignoreExperimental()Les règles expérimentales sont en voie d'être retirées et ignoreExperimental() sera supprimée dans la version d'octobre 2026. Pour désactiver une règle spécifique, utilisez ignore(rule:) à la place (voir Ignorer les règles ci-dessus).
Réinitialiser les Règles Ignorées
Dans votre suite de tests automatisés, vous souhaiterez peut-être démarrer un nouveau jeu de tests et restaurer toutes règles. Dans ce cas, vous pouvez effacer les règles ignorées que vous avez définies en utilisant les méthodes ci-dessus - avec l'API resetIgnoredRules.
@Before
fun setup() {
axe.resetIgnoredRules()
}
@Test
fun testButtonOnly() {
axe.ignoreRules(listOf("ScreenTitle"))
...
}
@Test
fun testScreenTitle() {
...
}