# Checkbox Group

<flow-checkbox-group>

Reactive

Stable

The checkbox group component adds Flo.w reactivity to a group of checkboxes.

The value property of the checkbox group component is an array of the individual value properties corresponding to selected checkboxes in the group. It can be get and set programmatically. The component will emit the flowCheckboxGroupChange when checkboxes are checked or unchecked following user action.

The component's value can also be bound to a Flo.w reactive state property. Checking or unchecking a checkbox in the group will trigger an update of the bound state property and vice versa.

WARNING

To add checkbox groups to a navigation list use a checkbox-type List Item instead.

# Examples

# Horizontal Checkboxes

# Properties

Property	Description	Type	Default
`disabled`	Set to `true` to disable interaction with the checkbox group.	`boolean`	`false`
`flowContext` `flow-context`	The Flo.w context ID to use for application state.	`string`	`'default'`
Reactive `selectionState` `selection-state`	Set to bind a Flo.w application state property to the group. The state property is an array of `value` attributes corresponding to checked checkboxes.	`string`
`value`	The value attribute of the checkbox group.	`string[]`	`[]`

# Events

Event	Description	Type
`flowCheckboxGroupChange`	Emitted when the control's checked state changes.	`any`

# Slots

Slot	Description
`(default)`	Child checkboxes to place in the checkbox group.

← Checkbox Chip →