Skip to main content Skip to site Map

iOS Checkbox

How to test a checkbox

Gherkin Condensed

Given that I am on a screen with a checkbox

1 Keyboard

WHEN I use the arrow keys or ctrl + tab to move focus to a checkbox I SEE focus is visually indicated (strongly if high contrast enabled)
Then when I use the spacebar to activate the checkbox I SEE the state is changed

2 VoiceOver screenreader

WHEN I use a screenreader AND I swipe to focus on a checkbox input
- I HEAR its purpose is clear and matches visible label
- I HEAR it identifies itself as a button or switch button
- I HEAR any visible label is read with the checkbox in a single swipe
- I HEAR it expresses its state (selected, checked, unchecked, dimmed)
Then when I doubletap with the checkbox in focus I HEAR the state is changed

3 Device settings

When I use Text resize I SEE text can resize up to 200% without losing information
When I use Increase contrast I SEE focus outline becomes high contrast

1 Keyboard actions

When I use	I see/hear
Arrow keys or ctrl + tab	Focus visibly moves to the checkbox
Spacebar	Element toggles between states

2 Mobile screenreader gestures

When I use	I hear
Swipe	Focus moves to the element, expresses its name, role, state (only if selected)
Doubletap	Element toggles between states

3 Screenreader output

Reads	I hear
Name	Its purpose is clear and matches visible label
Role	It identifies itself as a button or switch button
Group	Any visible label is read with the checkbox in a single swipe
State	It expresses its state (selected, checked, unchecked, dimmed)

4 Device settings

When I use	I see
Text resize	Text can resize up to 200% without losing information
Increase contrast	Focus outline becomes high contrast

Usage

There is no native iOS checkbox, so stop trying to make one.

Role & states

A checkbox will be made from a modified toggle switch or a button

If made from a button (most common)
- Its role will be button
- It will have only one declared state of selected; unselected will not be read on focus
If made from a toggle switch
- Its role will be switch or switch button
- It will have two mutually exclusive states — checked/unchecked

Apple HIG

Related checkbox entries