Skip to content

Commit d2638d2

Browse files
committed
Updated auditing section.
1 parent 0fde811 commit d2638d2

File tree

1 file changed

+18
-3
lines changed

1 file changed

+18
-3
lines changed

docs/talkback-guidelines.md

+18-3
Original file line numberDiff line numberDiff line change
@@ -307,17 +307,32 @@ In this codebase, the `WPSnackBar` component has functionality that detects if t
307307
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`.
308308

309309
## <a name="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+
310325
#### Manual testing
311-
Interact with your app using Android accessibility services.
312326

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.
314328

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.
315330

316331
Testing with analysis tools
317332

318333
Use tools to discover opportunities to improve your app's accessibility.
319334

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.
321336
* 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.
322337
* 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.
323338
* 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

Comments
 (0)