You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/talkback-guidelines.md
+18-3
Original file line number
Diff line number
Diff line change
@@ -307,17 +307,32 @@ In this codebase, the `WPSnackBar` component has functionality that detects if t
307
307
So in this case the `ToggleButton` which normally gets announced as a `Switch` is now being announced as a `Button` and it's no longer `checkable` so the announcement doesn't say `Tap to toggle` it says `Tap to activate`.
308
308
309
309
## <aname="auditing"></a>Auditing & Testing
310
+
311
+
There are several tools and approaches you can utilize to audit your app for TalkBack.
312
+
313
+
When you are performing your audit, you can utilize these guiding questions to help:
314
+
315
+
* Is the navigation order of TalkBack what you are expecting?
316
+
* Are there decorative elements on the screen that are gaining focus that should be inaccessible?
317
+
* Are there elements that should be accessible but they aren't?
318
+
* Are there elements that belong to a group and are being focused individually?
319
+
* Is the content description, type and action of each element appropriate? Eg. `ToggleButton` that was behaving like a `Switch` but was being used like a `Button`.
320
+
* Are all the strings being used in the content descriptions and actions localized?
321
+
* Is the touch target of the view large enough for it to be easily selected?
322
+
* Do all elements have the appropriate contrast ratio for maximum visibility?
323
+
* Are there any state changes that aren't being announced?
324
+
310
325
#### Manual testing
311
-
Interact with your app using Android accessibility services.
312
326
313
-
You can test the app using TalkBack. TalkBack allows you to interact with the app utilizing it’s screen reading functionality where selecting or swiping over elements reads out their descriptions and actions. Utilizing this creates the experience a visually impaired person would have while using the app.
327
+
Interact with your app using Android accessibility services.
314
328
329
+
You can test the app using TalkBack since it's simply an app that's built on top of the accessibility services. TalkBack allows you to interact with the app utilizing it’s screen reading functionality where selecting or swiping over elements reads out their descriptions and actions. Utilizing this creates the experience a visually impaired person would have while using the app.
315
330
316
331
Testing with analysis tools
317
332
318
333
Use tools to discover opportunities to improve your app's accessibility.
319
334
320
-
* Accessibility Scanner - Utilizing the Accessibility Test Framework it scans your screen and provides ways in which your accessibility can be improved by making changes to your labels, clickable items and other behaviour.
335
+
* Accessibility Scanner - Utilizing the Accessibility Test Framework it scans your screen and provides ways in which your accessibility can be improved by making changes to your labels, clickable items and other behaviour. The report normally focuses on touch targets, contrasts ratios, and repetitive content descriptions.
321
336
* Google Play pre launch report - When you upload the app for distribution Google Play generates a report utilizing the Accessibility Test Framework that can be used to identify improvements that can be made.
322
337
* UI Automator Viewer - Can scan the views of an app that’s running on a device and provide means by which the layout hierarchy can be analyzed at a deeper level. This is especially useful if other manual tests are being carried out, and it reveals views that aren’t being focused or made accessible to the framework, and a specific layout related change may need to be done to resolve the issue.
323
338
* Lint - lint warnings are shown in the build phase for various accessibility issues that may arise. These lint warnings can even be enforced to break the build so developers are forced to implement accessibility-related attributes.
0 commit comments