Print this page

checkbox

Characteristics

Superclass Role:

  • input

Subclass Roles:

  • menuitemcheckbox
  • radio

Related Concepts:

  • HTML input [type="checkbox"]
  • option

Required States and Properties:

  • aria-checked (state)

Inherited States and Properties:

  • aria-atomic
  • aria-busy (state)
  • aria-controls
  • aria-describedby
  • aria-disabled (state)
  • aria-dropeffect
  • aria-flowto
  • aria-grabbed (state)
  • aria-haspopup
  • aria-hidden (state)
  • aria-invalid (state)
  • aria-label
  • aria-labelledby
  • aria-live
  • aria-owns
  • aria-relevant

Name From:

  • contents
  • author

Accessible Name Required:

  • True

Implicit Value for Role:

  • Default for aria-checked (state) is false.

A checkable input that has three possible values: true, false, or mixed.

The checkable input that has three states. Checked, unchecked and mixed. In most  cases, checked state and unchecked state is observed. The checkbox role is used in a input type radio button. Many checkboxes do not use the mixed value, and thus are effectively boolean checkboxes. For a normal input type checkbox, the screen readers by default behavior announces them as checkboxes. For input type radio buttons, if the authors want to intimate the user as checkbox, the checkbox role can be used.

aria-checked (state) can be used in conjunction with checkbox role. The aria-checked (state) will intimate the user about the state of the checkbox. Aria-checked="true" indicates the checked state of the checkbox and false indicates the unchecked state.

Syntax

<input type="radio" role="checkbox" aria-checked="true" aria-label="Male" />

Microsoft Active Accessibility accRole Property: 

  • ROLE_SYSTEM_CHECKBUTTON

UI Automation ControlType Property: 

  • Checkbox

UI Automation AriaRole Property: 

  • checkbox