What is FastPass?
FastPass is a lightweight, two-step process that helps developers identify common, high-impact accessibility issues in less than five minutes.
- Automated checks - the tool automatically checks for several programmatically-detectable accessibility issues, such as low contrast, missing accessible names, or inadequate touch target sizes. The rules are based on axe-android, an open source accessibility rules library developed by Deque Systems.
- Manual test for tab stops - the tool provides clear instructions and a visual helper that makes it easy to identify critical accessibility issues related to keyboard access, such as missing tab stops, keyboard traps, and incorrect tab order.
We recommend developers run a FastPass before every check-in of UI code.
- Completing a FastPass requires you to use standard keyboard commands and to visually identify interactive interface elements.
- Automated checks can detect some common accessibility problems such as missing or invalid properties. But most accessibility problems can only be discovered through manual testing. The best way to evaluate web accessibility compliance is to complete an assessment.
How to complete a FastPass
Run automated checks
These instructions assume you have already set up Accessibility Insights for Android on your computer and test device.
On your Android device:
- Launch your test app.
- Navigate to the first screen you want to test.
On your computer:
- Launch Accessibility Insights for Android.
- When the screen says Connected and ready to go!, select Start testing.
When the automated checks have completed, results are displayed in a new window. The window shows:
- The navigation pane, with Automated checks selected
- The total number of failed instances
- A list of any accessibility rules that were violated
- The number of failed instances for each rule
- A screenshot of the target app, with any failed instances highlighted
A rule can be expanded to show information about its failed instances. Rules can be expanded or collapsed:
- All at once by selecting Expand all / Collapse all
- Individually by clicking a rule, or by tabbing to it and pressing Enter
Expanding a rule:
- Shows links to additional information about the rule, including why it matters, examples, and detailed instructions for fixing
- Highlights its failed instances in the screenshot
- Shows the failed instances in a list
The Visual helper toggle allows you to quickly show or hide failure instance highlighting in the screenshot.
Each failed instance includes:
- The class name of the element that failed
- How to fix the detected issue
- Additional information to help identify the element (some rules only)
Selecting a failed instance highlights it in the screenshot. An instance can be selected or deselected by clicking it, or by tabbing to it and pressing Enter. You can select multiple instances.
Complete the manual test for tab stops
The Tab stops test can be completed on a virtual or physical device using the virtual keyboard built into Accessibility Insights for Android. However, you can use a physical keyboard if you prefer.
- If you're testing on a physical device, you can use a Bluetooth keyboard attached directly to your physical device.
- If you're testing on a virtual device, you can use the keyboard attached to your desktop computer. To complete the Tab stops test:
In the navigation pane, select Tab stops.
Accessibility Insights for Android will show:
- The navigation pane, with Tab stops selected
- A Show tab stops toggle (off by default)
- How to test instructions
- A virtual keyboard with only the keys needed to complete the test (Tab, Up, Down, Left, Right, and Enter)
- In your target app, navigate to the screen you want to test, and make sure the UI is in the correct start state. For example, you might want to test the UI with the focus in its default state.
- Turn on the Show tab stops toggle. In the target app, if an element has input focus, it will be highlighted by an empty circle.
- If you're testing on a virtual device, switch to the emulator app by pressing Alt+Tab (Windows or Linux) or Command+Tab (Mac).
- Use the virtual keyboard in Accessibility Insights (or a physical keyboard) to navigate through your app:
- First navigate linearly through all the interactive elements using only the Tab key.
- Then navigate to each interactive element and use the arrow keys to navigate away in each direction (up/down/left/right). In the target app, numbered circles will appear on elements that receive input focus.
- As you navigate to each element, look for these accessibility problems:
- An interactive element can't be reached using the Tab and arrow keys.
- An interactive element "traps" input focus and prevents navigating away.
- An interactive element doesn't give a visible indication when it has input focus.
- The navigation order is inconsistent with the logical order that's communicated visually.
- Input focus moves unexpectedly without the user initiating it.
Optional: Evaluate instances that need review
Sometimes an automated check encounters an element coded in a way that it can't be evaluated automatically. For example, the color-contrast rule can't determine the contrast ratio of text that's superimposed on an image or gradient. Such instances need to be reviewed by a human to determine whether they pass or fail.
- In the navigation pane, select Needs review.
The window will show:
- The navigation pane, with Needs review selected
- The total number of instances that need review
- A list of any accessibility rules that might be violated
- The number of instances for each rule
- A screenshot of the target app, with any instances to review highlighted
- Expand a rule to see its instances.
- To determine whether an instance passes or fails, follow the How to check instructions.
File an issue
Each failed instance in Automated checks and Needs review has a disclosure button that reveals more actions.
- You can file an issue in your GitHub or Azure Boards repository.
- You can copy the failure details to your clipboard and paste them into the tool or document of your choice. Learn more about issue filing.
Share a detailed report of the automated checks
- In the navigation pane, select Automated checks.
- In the command bar, select Export result.
- Optional: Enter a description to include in the report.
- Select Export.
- Select the folder where you'd like to save the report.
- Select Save.
The Start over button, also in the command bar, allows you to quickly run the automated checks on whatever content is currently visible on your connected device.