Skip to main content

CheckBox

WATCH & LEARN0:48 · Animated tutorial
7 scenesPlay, pause, or scrub at your own pace

Use a CheckBox to give the user an option, such as true/false or yes/no. The CheckBox control can display an image or text or both.

CheckBox and RadioButton controls serve similar functions: they allow users to choose from a list of options. CheckBox controls let users pick multiple options simultaneously, while RadioButton controls restrict users to one choice from mutually exclusive options.

The Appearance property determines whether the CheckBox appears as a typical CheckBox, a button, or as a switch.

The ThreeState property determines whether the control supports two or three states. Use the Checked property to get or set the value of a two-state CheckBox control and the CheckState property to get or set the value of a three-state CheckBox control.

info

For a complete list of properties, methods, and events, see the API documentation.

Features​

Check States​

Use CheckState to set or read one of three states: Checked, Unchecked, or Indeterminate. Enable ThreeState when the user should be able to cycle through all three.

Checkbox control demonstrating the three possible check states

Check Alignment​

The CheckBox icon can be configured to show on the left or right side of the text.

Checkbox control showing different text alignment options

Icons​

Icons can be placed in various positions around the checkbox including above, below, beside, and more.

Animated demonstration of checkbox icon positioning options

Advanced​

JavaScript Widget​

ItemDescription
Class name"wisej.web.CheckBox"
Theme appearance"checkbox", see Themes.
Child components"icon" is the checkbox icon, "label" is the text. See JavaScript.
Source codehttps://github.com/iceteagroup/wisej-js