RFR: 8348936: [Accessibility,macOS,VoiceOver] VoiceOver doesn't announce untick on toggling the checkbox with "space" key on macOS [v3]

Fri Feb 14 04:32:54 UTC 2025

On Wed, 12 Feb 2025 17:41:46 GMT, Alexey Ivanov <aivanov at openjdk.org> wrote:

>> Are you suggesting to change entire instruction set with HTML formatting ?
>> 
>> I would appreciate if you add some sample changes. you are referring
>
> Here's the sample that I used:
> 
> <details>
> <summary>HTML code for instructions</summary>
> 
> 
>         String INSTRUCTIONS = """
>                 <html><body>
>                 <p><b>Testing with VoiceOver</b></p>
> 
>                 <ol>
>                   <li>Start the VoiceOver application
>                       (Press <kbd>Command</kbd> + <kbd>F5</kbd>)
>                   <li>Click on the <i>Frame with CheckBox and ToggleButton</i>
>                       window to move focus
>                   <li>Press <kbd>Spacebar</kbd>
>                   <li>VO should announce the checked state
>                   <li>Press <kbd>Spacebar</kbd> again
>                   <li>VO should announce the unchecked state
>                   <li>Press <kbd>Tab</kbd> to move focus to <i>ToggleButton</i>
>                   <li>Repeat steps 3 to 6 and listen the announcement
>                   <li>If announcements are incorrect, press <b>Fail</b>
>                   <li>Stop the VoiceOver application
>                       (Press <kbd>Command</kbd> + <kbd>F5</kbd> again)
>                 </ol>
> 
>                 <p><b>Testing with Screen Magnifier</b></p>
>                 <ol style="margin-bottom: 0">
>                   <li>Enable Screen magnifier on the Mac:
>                    <b>System Settings</b> -> <b>Accessibility</b> ->
>                    <b>Hover Text</b> -> <b>Enable Hover Text</b><br>
>                    Default Hover Text Activation Modifier is <kbd>Command</kbd> key.
>                   <li>Move focus back to test application
> 
>                   <ul style="margin-bottom: 0">
>                     <li>Test <i>CheckBox</i> states with Screen Magnifier
>                       <ol style="list-style-type: lower-alpha; margin-top: 0; margin-bottom: 0">
>                         <li>Click on <i>CheckBox</i> to select it
>                         <li>Press the <kbd>Command</kbd> key and
>                             hover mouse over <i>CheckBox</i>
>                         <li>CheckBox ticked state along with its label should be magnified
>                         <li>Keep the <kbd>Command</kbd> key pressed and
>                             click <i>CheckBox</i> to deselect it
>                         <li>CheckBox unticked state along with its label should be magnified
>                         <li>Release the <kbd>Command</kbd> key
>                         <li>If Screen Magnifier behaviour is incorrect, press <b>Fail</b>
>                       </ol>
>                     <li>Test <i>ToggleButton</i> states with Screen Magnifier
>    ...

Updated test instructions for HTML style formatting. Thanks for the code snippet @aivanov-jdk

-------------

PR Review Comment: https://git.openjdk.org/jdk/pull/23436#discussion_r1955540492