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/pages/device-controls.adoc b/docs/modules/manual-testing/pages/device-controls.adoc index e1c94ebc..5709f4ce 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 VoiceOver guide. 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..e69de29b 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