diff --git a/docs/modules/manual-testing/images/enable-screenreader.png b/docs/modules/manual-testing/images/enable-screenreader.png new file mode 100644 index 00000000..67160924 Binary files /dev/null and b/docs/modules/manual-testing/images/enable-screenreader.png differ diff --git a/docs/modules/manual-testing/images/show-lightningmode.png b/docs/modules/manual-testing/images/show-lightningmode.png new file mode 100644 index 00000000..ed5af73a Binary files /dev/null and b/docs/modules/manual-testing/images/show-lightningmode.png differ diff --git a/docs/modules/manual-testing/images/talkback-timeline.png b/docs/modules/manual-testing/images/talkback-timeline.png new file mode 100644 index 00000000..9cdcad2c Binary files /dev/null and b/docs/modules/manual-testing/images/talkback-timeline.png differ diff --git a/docs/modules/manual-testing/images/voiceover-manual-session.png b/docs/modules/manual-testing/images/voiceover-manual-session.png new file mode 100644 index 00000000..9072bf74 Binary files /dev/null and b/docs/modules/manual-testing/images/voiceover-manual-session.png differ diff --git a/docs/modules/manual-testing/nav.adoc b/docs/modules/manual-testing/nav.adoc index ffdeca73..4f2d5172 100644 --- a/docs/modules/manual-testing/nav.adoc +++ b/docs/modules/manual-testing/nav.adoc @@ -12,6 +12,11 @@ ** xref:manual-testing:local-devices/capture-network-payload-data.adoc[] ** xref:manual-testing:local-devices/use-apple-pay-in-manual-session.adoc[] +* Screen reader (accessibility) +** xref:manual-testing:screen-reader/talkback-manual-session.adoc[] +** xref:manual-testing:screen-reader/voice-over-manual-session.adoc[] +** xref:manual-testing:screen-reader/screen-reader-gestures.adoc[] + * xref:manual-testing:inject-audio.adoc[] * xref:manual-testing:test-your-app-camera.adoc[] * xref:manual-testing:adb-commands.adoc[] diff --git a/docs/modules/manual-testing/pages/device-controls.adoc b/docs/modules/manual-testing/pages/device-controls.adoc index e1c94ebc..cd7129af 100644 --- a/docs/modules/manual-testing/pages/device-controls.adoc +++ b/docs/modules/manual-testing/pages/device-controls.adoc @@ -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]. diff --git a/docs/modules/manual-testing/pages/screen-reader-gestures.adoc b/docs/modules/manual-testing/pages/screen-reader-gestures.adoc new file mode 100644 index 00000000..2d944007 --- /dev/null +++ b/docs/modules/manual-testing/pages/screen-reader-gestures.adoc @@ -0,0 +1,145 @@ += Screen Reader Gestures + +Supported keyboard shortcuts for VoiceOver (iOS) and TalkBack (Android) for the connected device. + +During a session, a reference modal displays the available actions. Select an action in the modal or use the corresponding key to interact with the device. + +== VoiceOver (iOS) + +=== Navigation and Interaction + +[cols="1,1,3", options="header"] +|=== +| Action | Key | Description + +| Next +| Right Arrow +| Move to the next item + +| Previous +| Left Arrow +| Move to the previous item + +| Activate +| Space +| Activate the selected item + +| Back or Close +| Esc +| Go back or close the current view + +| Open item chooser +| I +| Open the item chooser + +| Next option +| Up Arrow +| Move to the next option + +| Previous option +| Down Arrow +| Move to the previous option + +| Home screen +| H +| Go to the Home screen + +| Status bar +| M +| Move focus to the status bar + +| Help +| K +| Open VoiceOver Help +|=== + +=== Reading and Speech + +[cols="1,1,3", options="header"] +|=== +| Action | Key | Description + +| Read from top +| B +| Read from the top of the screen + +| Read from current item +| A +| Read starting from the selected item + +| Pause or resume speech +| Control +| Pause or resume speech output +|=== + +=== Text Editing + +[cols="1,1,3", options="header"] +|=== +| Action | Key | Description + +| Next text field +| Tab +| Move to the next text field + +| Previous text field +| Shift + Tab +| Move 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 +|=== + +== TalkBack (Android) + +=== Navigation and Interaction + +[cols="1,2,3", options="header"] +|=== +| Action | Key | Description + +| Next +| Right Arrow (Alt + Right Arrow) +| Move to the next item + +| Previous +| Left Arrow (Alt + Left Arrow) +| Move to the previous item + +| Activate +| Space (Alt + Space) +| Activate the selected item + +| Back +| Backspace (Alt + Backspace) +| Go back + +| Home +| H (Alt + Ctrl + H) +| Go to the Home screen + +| Recent apps +| R (Alt + Ctrl + R) +| Open Recent apps +|=== \ No newline at end of file diff --git a/docs/modules/manual-testing/pages/screen-reader/screen-reader-gestures.adoc b/docs/modules/manual-testing/pages/screen-reader/screen-reader-gestures.adoc new file mode 100644 index 00000000..442c1b5e --- /dev/null +++ b/docs/modules/manual-testing/pages/screen-reader/screen-reader-gestures.adoc @@ -0,0 +1,150 @@ += Screen reader gestures and keyboard shortcuts +: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. + +== Navigation and interaction + +[cols="1,1,3", options="header"] +|=== +| Action | Gesture/Key | Description + +| Next +| Right arrow +| 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 +|=== diff --git a/docs/modules/manual-testing/pages/screen-reader/talkback-manual-session.adoc b/docs/modules/manual-testing/pages/screen-reader/talkback-manual-session.adoc new file mode 100644 index 00000000..828ce05d --- /dev/null +++ b/docs/modules/manual-testing/pages/screen-reader/talkback-manual-session.adoc @@ -0,0 +1,75 @@ += Test TalkBack in a manual Android sessions +:navtitle: Test TalkBack (Android) + +== Overview + +Android TalkBack is supported in manual testing sessions. + +TalkBack provides audio feedback and keyboard-based navigation. It helps teams identify accessibility issues that may not be detected through visual testing alone. + +== Requirements + +To use TalkBack, you need: + +* Android 12 or later +* A device with Lightning mode enabled + +No additional configuration is required. + +== Verify Lightning Mode Support + +TalkBack is available only on devices that support Lightning mode. + +To verify whether a device supports Lightning mode: + +. Switch to *List view* in the Device List. +. Open the column selector. +. Enable the *Lightning mode* column. + +The Device List allows up to 10 visible columns. If you can’t select the Lightning mode option, disable an existing column and then enable Lightning mode. + +Devices that support Lightning mode display a green lightning bolt icon. + +image:show-lightningmode.png[width=750,alt="Lightning mode column enabled in the Device List"] + +[NOTE] +==== +You can also filter for Lightning mode devices using the *Search devices* field. +==== + +== Enable TalkBack + +. Start a manual session on a supported Android device. +. In the left navigation panel, select *Screen Reader*. +. Toggle *Enable*. + +When TalkBack is enabled: + +* Audio feedback starts automatically. +* Keyboard shortcuts become active. +* Screen reader activity is logged in Session Explorer. + +image:enable-screenreader.png[width=750,alt="Screen Reader panel showing TalkBack enabled"] + +== Navigate Using Keyboard Shortcuts + +When TalkBack is enabled, you can use keyboard shortcuts to navigate the device. + +The Screen Reader modal displays available shortcuts for Android devices. + +Shortcuts are active only while TalkBack is enabled. + +== Review TalkBack Activity + +TalkBack actions are recorded in Session Explorer. + +Accessibility events are labeled as `TALKBACK` in the session timeline. This allows you to review navigation behavior alongside screenshots and other test actions. + +image:talkback-timeline.png[width=750,alt="Session timeline showing recorded TalkBack gestures and accessibility events"] + +== Behavior Notes + +* Audio streaming starts automatically when TalkBack is enabled. +* The focus border might not appear immediately after enabling TalkBack. Select an interactive element to display it. +* The focus border might not disappear immediately after disabling TalkBack. Select an interactive element to hide it. +* For permission pop-ups, only interactive elements (such as buttons and text fields) are read aloud and selectable. diff --git a/docs/modules/manual-testing/pages/screen-reader/voice-over-manual-session.adoc b/docs/modules/manual-testing/pages/screen-reader/voice-over-manual-session.adoc new file mode 100644 index 00000000..35cb86c7 --- /dev/null +++ b/docs/modules/manual-testing/pages/screen-reader/voice-over-manual-session.adoc @@ -0,0 +1,43 @@ += Test VoiceOver in manual iOS sessions +: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 diff --git a/docs/modules/manual-testing/pages/test-your-app-camera.adoc b/docs/modules/manual-testing/pages/test-your-app-camera.adoc index 019e1de6..548ddcfe 100644 --- a/docs/modules/manual-testing/pages/test-your-app-camera.adoc +++ b/docs/modules/manual-testing/pages/test-your-app-camera.adoc @@ -3,7 +3,7 @@ Learn how to test your app camera using image injection, so you can ensure end-users can take photos or scan QR codes with your app. -== Before you start +== Before you begin Enable image injection for your app with one of these options: diff --git a/docs/modules/manual-testing/pages/voice-over-manual-session.adoc b/docs/modules/manual-testing/pages/voice-over-manual-session.adoc new file mode 100644 index 00000000..326f7f2b --- /dev/null +++ b/docs/modules/manual-testing/pages/voice-over-manual-session.adoc @@ -0,0 +1,42 @@ += VoiceOver in Manual iOS Sessions + +== 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-gestures.adoc[VoiceOver gestures and commands]. + +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