Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Inspecter
Plusieurs outils peuvent vous aider à inspecter rapidement votre contenu d'un point de vue d'accessibilité:
Android Accessibility Suite: comprend le menu d'accessibilité, Sélectionner pour prononcer, Switch Access et TalkBack, qui fournissent des informations sur le fonctionnement de la sémantique de votre application pour les utilisateurs de ces technologies. Nous vous recommandons vivement de tester votre application avec les technologies d'assistance d'Android, car c'est le meilleur moyen de comprendre l'expérience de vos utilisateurs ayant des besoins d'accessibilité.
Inspecteur de mise en page: vous permet d'inspecter et de déboguer la sémantique de chaque composable, et d'identifier les informations manquantes ou incorrectes.
Application Accessibility Scanner: analyse votre écran et vous propose des suggestions pour améliorer son accessibilité en identifiant certains écueils courants.
Déboguer
Entre Compose, le système de sémantique et les services d'accessibilité Android, vous pouvez rencontrer des comportements d'accessibilité inattendus difficiles à suivre.
Les propriétés sémantiques peuvent vous aider à comprendre pourquoi vos composants se comportent comme ils le font.
Vous pouvez déboguer les problèmes de comportement d'accessibilité avec l'outil d'inspection de la mise en page dans Android Studio, TreeDebug dans les paramètres pour les développeurs de TalkBack ou printToLog de ComposeTestRule. Tous ces outils peuvent fournir des informations sur les nœuds (et leurs propriétés) exposés aux services d'accessibilité par Compose.
L'exemple suivant utilise l'outil d'inspection de la mise en page pour déboguer un écran comportant trois éléments. Lorsque les services d'accessibilité sont activés, le premier n'est pas sélectionné et le second n'a aucun retour d'action associé. Vous pouvez examiner les propriétés sémantiques pour identifier les problèmes potentiels.
L'arborescence des composants dans l'outil d'inspection de la mise en page contient des informations sur les limites, les paramètres et d'autres informations sémantiques associées à un élément. Dans l'arborescence, les trois éléments sont reconnus:
Figure 2. Outil d'inspection de la mise en page avec les trois éléments.
La propriété hideFromAccessibility est appliquée au premier élément. Cela indique que l'élément peut être marqué comme masqué quelque part dans l'arborescence sémantique ou qu'il est masqué par une superposition décorative.
Figure 3. Outil d'inspection de la mise en page: premier élément avec hideFromAccessibility.
Le deuxième élément possède une propriété de focus, mais pas de onClick comme l'élément précédent. Par conséquent, il est possible qu'un modificateur clickable soit manquant quelque part, ce qui explique qu'un service d'accessibilité tel que TalkBack n'annonce pas de signal d'action à l'utilisateur:
Figure 4. Outil d'inspection de la mise en page: deuxième élément avec focused.
Le troisième élément de texte possède toutes les propriétés nécessaires (il peut être sélectionné, possède un onClick et d'autres sémantiques supplémentaires appliquées), c'est pourquoi il est interprété comme prévu.
Figure 5 : Outil d'inspection de la mise en page: troisième élément avec toutes les API.
Vous pouvez ainsi utiliser des outils de débogage pour déterminer pourquoi certaines annonces ou sélections ne sont pas effectuées par les services d'accessibilité.
Recommandations personnalisées
Remarque : Le texte du lien s'affiche lorsque JavaScript est désactivé
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/27 (UTC)."],[],[],null,["# Inspect and debug\n\nInspect\n-------\n\nSeveral tools can help you quickly inspect your content from an accessibility\npoint of view:\n\n- [Android Accessibility Suite](https://play.google.com/store/apps/details?id=com.google.android.marvin.talkback): Includes Accessibility Menu, Select to Speak, Switch Access, and TalkBack, which provide insight into how your app's semantics work for users of these technologies. Testing with Android's assistive technologies is highly recommended as the best way to understand what your users with accessibility needs will experience.\n- [Layout Inspector](/develop/ui/compose/tooling/debug#layout_inspector): Lets you inspect and debug semantics of each composable, and helps identify any missing or incorrect information.\n- [Accessibility Scanner](https://support.google.com/accessibility/android/answer/6376570) app: Scans your screen and provides suggestions to improve its accessibility by identifying some common pitfalls.\n\nDebug\n-----\n\nBetween Compose, the semantics system, and Android accessibility services, you\nmight run into unexpected accessibility behaviors that are difficult to trace.\nSemantic properties can help you understand why your components are behaving\nthe way that they are.\n\nYou can debug accessibility behavior issues with the [Layout Inspector](/develop/ui/compose/tooling/debug#layout_inspector) in\nAndroid Studio, TreeDebug in TalkBack developer settings, or `ComposeTestRule`'s\n[`printToLog`](/reference/kotlin/androidx/compose/ui/test/package-summary#(androidx.compose.ui.test.SemanticsNodeInteraction).printToLog(kotlin.String,kotlin.Int)). All of these tools can provide information about nodes\n(and their properties) that are exposed to accessibility services by Compose.\n\nThe following example uses Layout Inspector to debug a screen with three\nelements where, with accessibility services on, the first one isn't being\nselected, and the second one doesn't have any action feedback associated with\nit. You can examine the semantic properties to find potential issues.\n\nThe component tree in Layout Inspector contains information about an element's\nbounds, parameters, and other semantic information associated with it. In the\ntree, all three elements are recognized:\n**Figure 2.** Layout Inspector with all three elements..\n\nThe first element has the `hideFromAccessibility` property applied. This\nindicates that the element may be marked as hidden somewhere in the semantics\ntree, or it is obscured by some decorative overlay.\n**Figure 3.** Layout Inspector: first element with `hideFromAccessibility`.\n\nThe second element has a focus property, but no `onClick` like the previous\nelement. Therefore, it might be missing a `clickable` modifier somewhere, which\nis why an accessibility service like TalkBack may not be announcing some\naction signal to the user:\n**Figure 4.** Layout Inspector: second element with `focused`.\n\nThe third text element has all the necessary properties---it is focusable, has\nan `onClick`, and other additional semantics applied---which is why it's\ninterpreted as expected.\n**Figure 5.** Layout Inspector: third element with all APIs.\n\nIn this way, you can use debugging tools to investigate why certain\nannouncements or selections aren't performed by accessibility services.\n\nRecommended for you\n-------------------\n\n- Note: link text is displayed when JavaScript is off\n- [Accessibility in Compose](/develop/ui/compose/tooling/debug#layout_inspector)\n- \\[Material Design 2 in Compose\\]\\[19\\]\n- [Testing your Compose layout](https://support.google.com/accessibility/android/answer/6376570)"]]
