selection/DSCheckbox
DSCheckbox
selectionMulti-select checkbox with a checkmark animation. Supports indeterminate state for parent checkboxes.
iOS 17+macOS 14+watchOS 10+tvOS 17+visionOS 1+
Purpose
Multi-selection in forms, lists, and permission screens.
Interactive Reference
Live showroom
Need the full visual surface?
Screenshots do not scale well across every component, state, and variant. For the real interactive reference, import the package and launch DSShowcaseRoot().
Best for exploring:
variants, states, categories, and real app examples in one place.
States
unchecked
Hollow square with a border.
checked
Filled with primary colour and animated checkmark.
indeterminate
Dash — used for parent select-all.
disabled
50% opacity.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| labelreq | String | — | Checkbox label (first, unlabeled argument). |
| isCheckedreq | Binding<Bool> | — | Binding to the checked state. |
| isDisabled | Bool | false | Disables interaction. |
| color | Color? | nil | Checked fill color. nil uses the theme primary. |
Examples
Permission list
Multi-select permission screen.
swift
ForEach(permissions) { perm in
DSCheckbox(perm.name, isChecked: $perm.isGranted)
}