AurumCheckboxGroup
Aurum's checkbox group — a vertical stack of independently-selectable options.
| family | Selection |
|---|---|
| platform | iOS 17+ · SwiftUI |
| figma | component master ↗ |
| source | Sources/Aurum/Component/Selection/AurumCheckboxGroup.swift |
| code connect | FigmaConnect/Sources/AurumFigmaConnect/AurumCheckboxGroup.figma.swift |
Aurum's checkbox group — a vertical stack of independently-selectable
options. The SwiftUI port of aurum-android's AurumCheckboxGroup
(Figma CheckboxGroup, node 5169:1796).
Pass errorText to tint every option to feedback-negative and switch
the helper line to negative-intense.
Intended use
Use to present 2–7 independently-selectable options (filter facets, "select all that apply", terms-acceptance lists). For mutually-exclusive choice, use AurumRadioGroup instead. For more than 7 options switch to a multi-select picker surface.
Do
- Keep
optionsto a stable, bounded set — not for paginated or remotely-fetched data. - Set
errorTextfor required-selection forms (e.g. consent); clear it as soon as the user picks a valid combination. - Place the group near its own contextual header — don't rely on
labelalone for grouping cues in dense forms.
Don’t
- Mix per-option
enabled: falsewith a top-levelenabled: false; pick one disable mode. - Use this for navigation lists where each tap moves the user — checkboxes capture inclusion state, not actions.
- Render the same option twice; the group assumes
valueuniqueness.
Code Connect
Mapped to Figma node 5169:1796 ↗ — SwiftUI snippets appear in Dev Mode for the latest release.