/*
* Copyright (c) 2025, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
import java.awt.BorderLayout;
import java.awt.GridLayout;
import javax.swing.JCheckBox;
import javax.swing.JFrame;
import javax.swing.JPanel;
import javax.swing.JToggleButton;
/*
* @test
* @bug 8348936 8345728
* @summary Verifies that VoiceOver announces the untick state of CheckBox and
* ToggleButton when space key is pressed. Also verifies that CheckBox
* and ToggleButton untick state is magnified with Screen Magnifier.
* @requires os.family == "mac"
* @library /java/awt/regtesthelpers
* @build PassFailJFrame
* @run main/manual TestJCheckBoxToggleAccessibility
*/
public class TestJCheckBoxToggleAccessibility {
public static void main(String[] args) throws Exception {
String INSTRUCTIONS = """
Testing with VoiceOver
- Start the VoiceOver application
(Press Command + F5)
- Click on the Frame with CheckBox and ToggleButton
window to move focus
- Press Spacebar
- VO should announce the checked state
- Press Spacebar again
- VO should announce the unchecked state
- Press Tab to move focus to ToggleButton
- Repeat steps 3 to 6 and listen the announcement
- If announcements are incorrect, press Fail
- Stop the VoiceOver application
(Press Command + F5 again)
Testing with Screen Magnifier
- Enable Screen magnifier on the Mac:
System Settings -> Accessibility ->
Hover Text -> Enable Hover Text
Default Hover Text Activation Modifier is Command key
- Move focus back to the test application and perform the following tests
- Test CheckBox states with Screen Magnifier
- Click on CheckBox to select it
- Press the Command key and
hover mouse over CheckBox
- CheckBox ticked state along with its label should be magnified
- Keep the Command key pressed and
click CheckBox to deselect it
- CheckBox unticked state along with its label should be magnified
- Release the Command key
- If Screen Magnifier behaviour is incorrect, press Fail
- Test ToggleButton states with Screen Magnifier
- Click on ToggleButton to select it
- Press the Command key and
hover mouse over ToggleButton
- Ticked state along with label should be magnified
- Keep the Command button pressed and
click ToggleButton to deselect it
- Unticked state along with its label should be magnified
- Release the Command key
- If Screen Magnifier behaviour is incorrect, press Fail
- Disable Hover Text (optionally) in the Settings
Press Pass if you are able to hear correct VoiceOver announcements and
able to see the correct screen magnifier behaviour.
""";
PassFailJFrame.builder()
.title("TestJCheckBoxToggleAccessibility Instruction")
.instructions(INSTRUCTIONS)
.columns(40)
.rows(25)
.testUI(TestJCheckBoxToggleAccessibility::createUI)
.testTimeOut(8)
.build()
.awaitAndCheck();
}
private static JFrame createUI() {
JFrame frame = new JFrame("A Frame with CheckBox and ToggleButton");
JCheckBox cb = new JCheckBox("CheckBox", false);
JToggleButton tb = new JToggleButton("ToggleButton");
JPanel p = new JPanel(new GridLayout(2, 1));
p.add(cb);
p.add(tb);
frame.getContentPane().add(p, BorderLayout.CENTER);
frame.setSize(400, 400);
return frame;
}
}