-
Notifications
You must be signed in to change notification settings - Fork 3
VoiceOver guide and Screen reader gestures #413
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
02a4732
051739e
613c5c9
45803e7
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,11 +1,11 @@ | ||
| = Device controls | ||
| :navtitle: Device controls | ||
|
|
||
| Use these device controls to interact with your device during a manual test session. | ||
| Interact with your device during a manual test session using these device controls. | ||
|
|
||
| == Touch | ||
|
|
||
| To interact with your device, select *Touch*, then use *left-click* to tap and swipe the device screen. | ||
| To interact with your device, select *Touch*, then *left-click* to tap and swipe the device screen. | ||
|
|
||
| image:manual-testing:select-touch-context.png[width=1000,alt="Select Touch on Manual session"] | ||
|
|
||
|
|
@@ -176,3 +176,12 @@ image:manual-testing:screenshot-context.png[width=750, alt="A manual session wit | |
| To download your screenshots, select *Screenshots*, then choose a screenshot to download. | ||
|
|
||
| image:manual-testing:select-screenshot-closeup.png[width=750,alt="Select screenshots you want to download"] | ||
|
|
||
| == VoiceOver | ||
|
|
||
| Use VoiceOver on iOS devices to test app accessibility. + | ||
| To enable it in a *Manual Session*, open the *Screen Reader* menu in the left navigation bar. | ||
|
|
||
| image:voiceover-manual-session.png[width=750, alt="Enable VoiceOver through the Screen Reader toggle in a manual session"] | ||
|
|
||
| For more information, see the xref:screen-reader/voice-over-manual-session.adoc[VoiceOver guide,window=read-later]. | ||
|
Collaborator
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I added link to the VoiceOver guide here so users can navigate to it. |
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,150 @@ | ||
| = Screen reader gestures and keyboard shortcuts | ||
|
Collaborator
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I changed from Title Case to Sentence case to match other docs. |
||
| :navtitle: Gestures and shortcuts | ||
|
|
||
| == Overview | ||
|
|
||
| Use these gestures to navigate and interact with devices when VoiceOver (iOS) is enabled. The gestures shown during a session automatically reflect the platform of the connected device. | ||
|
|
||
| During a manual session, a reference modal is available to show supported gestures and keyboard shortcuts. | ||
|
|
||
| [IMPORTANT] | ||
| On Windows computers, use the Windows key for keyboard shortcuts with CMD (command) key. | ||
|
Collaborator
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I added this note for Windows users. |
||
|
|
||
| == Navigation and interaction | ||
|
|
||
| [cols="1,1,3", options="header"] | ||
| |=== | ||
| | Action | Gesture/Key | Description | ||
|
|
||
| | Next | ||
| | Right arrow | ||
|
Collaborator
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I removed the
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Ohhh okay, I was wondering what that was there for. |
||
| | Move to the next item | ||
|
|
||
| | Previous | ||
| | Left arrow | ||
| | Move to the previous item | ||
|
|
||
| | Activate | ||
| | Space | ||
| | Activate the selected item | ||
|
|
||
| | Back / Close | ||
| | Esc | ||
| | Go back or close the current view | ||
|
|
||
| | Open item chooser | ||
| | I | ||
| | Open the item chooser | ||
|
|
||
| | Next option | ||
| | Up arrow | ||
| | Skip to the next option | ||
|
|
||
| | Previous option | ||
| | Down arrow | ||
| | Skip back to the previous option | ||
|
|
||
| | Home screen | ||
| | H | ||
| | Return to the home screen | ||
|
|
||
| | Status bar | ||
| | M | ||
| | Show the status bar | ||
|
|
||
| | Help | ||
| | K | ||
| | Open help or support | ||
| |=== | ||
|
|
||
| == Rotor controls | ||
|
|
||
| [cols="1,1,3", options="header"] | ||
| |=== | ||
| | Action | Gesture/Key | Description | ||
|
|
||
| | Next (Rotor) | ||
| | CMD + Right arrow | ||
| | Select next Rotor setting | ||
|
|
||
| | Previous (Rotor) | ||
| | CMD + Left arrow | ||
| | Select previous Rotor setting | ||
|
|
||
| | Increment (Rotor) | ||
| | CMD + Up arrow | ||
| | Increment Rotor value | ||
|
|
||
| | Decrement (Rotor) | ||
| | CMD + Down arrow | ||
| | Decrement Rotor value | ||
| |=== | ||
|
|
||
| == System and app management | ||
|
|
||
| [cols="1,1,3", options="header"] | ||
| |=== | ||
| | Action | Gesture/Key | Description | ||
|
|
||
| | Toggle MultiTask Pane | ||
| | H (x2) | ||
| | Toggle App Switcher | ||
| |=== | ||
|
|
||
| == Reading and speech | ||
|
|
||
| [cols="1,1,3", options="header"] | ||
| |=== | ||
| | Action | Gesture/Key | Description | ||
|
|
||
| | Read from top | ||
| | B | ||
| | Read all items from the top of the screen | ||
|
|
||
| | Read from current | ||
| | A | ||
| | Read all items starting from the current item | ||
|
|
||
| | Pause / Resume | ||
| | Control | ||
| | Pause or resume speech output | ||
| |=== | ||
|
|
||
| == Text editing and focus | ||
|
|
||
| [cols="1,1,3", options="header"] | ||
| |=== | ||
| | Action | Gesture/Key | Description | ||
|
|
||
| | Next text field | ||
| | Tab | ||
| | Move to the next text field | ||
|
|
||
| | Previous text field | ||
| | Shift + Tab | ||
| | Return to the previous text field | ||
|
|
||
| | Select all | ||
| | CMD + A | ||
| | Select all content | ||
|
|
||
| | Copy | ||
| | CMD + C | ||
| | Copy the selected content | ||
|
|
||
| | Cut | ||
| | CMD + X | ||
| | Cut the selected content | ||
|
|
||
| | Paste | ||
| | CMD + V | ||
| | Paste the copied or cut content | ||
|
|
||
| | Undo | ||
| | CMD + Z | ||
| | Undo the last action | ||
|
|
||
| | Redo | ||
| | Shift + CMD + Z | ||
| | Redo the last action | ||
| |=== | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,43 @@ | ||
| = Test VoiceOver in manual iOS sessions | ||
|
Collaborator
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I changed the title to start with an action to match other docs. Also updated from Title Case from Sentence case. |
||
| :navtitle: Test VoiceOver (iOS) | ||
|
|
||
| == Overview | ||
|
|
||
| Test accessibility on iOS devices during a manual session using VoiceOver. | ||
|
|
||
| == Prerequisites | ||
|
|
||
| Before using VoiceOver in a manual session, ensure the following requirements are met: | ||
|
|
||
| * A private iOS device that supports a Bluetooth keyboard | ||
| * The iOS device must operate in Lightning mode to support audio output during manual testing sessions. | ||
|
|
||
| NOTE: Audio output during VoiceOver testing is supported only on devices configured with Bluetooth keyboard access. | ||
|
|
||
| == Using VoiceOver During a Manual Session | ||
|
|
||
| When a manual session is active: | ||
|
|
||
| * The Screen Reader icon is selectable in the left toolbar | ||
| * Selecting the icon opens a floating Screen Reader modal | ||
|
|
||
| image:voiceover-manual-session.png[width=750, alt="Screenshot of the Screen Reader modal"] | ||
|
|
||
| From the Screen Reader modal, users can: | ||
|
|
||
| * Turn VoiceOver mode on or off using the toggle | ||
| * Select a gesture or command to perform the corresponding action on the device screen | ||
| * Listen to VoiceOver output while navigating and interacting with the device | ||
|
|
||
| For a complete list of supported gestures, see xref:screen-reader/screen-reader-gestures.adoc[VoiceOver gestures and commands,window=read-later]. | ||
|
|
||
| Each gesture or command includes: | ||
|
|
||
| * A supporting description explaining its behavior | ||
| * A keyboard shortcut displayed in the modal | ||
|
|
||
| While VoiceOver mode is enabled: | ||
|
|
||
| * Other toolbar tools remain available | ||
| * The device screen can still be interacted with normally | ||
| * VoiceOver gestures supplement, rather than replace, standard interaction | ||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I moved all docs related to VoiceOver under this category and added navigation items for them.