Skip to main content
161

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
Apple docs
FormsApple

Checkbox

Capture a controlled Boolean choice with a generous native target and supporting text.

Public APILumenCheckboxApple / SwiftUISwift product: LumenUI

Apple availability

Supported native targets

Import LumenUI in the target that uses this component. iPad support follows the iOS package baseline and uses native iPad layout behavior.

iPhone · iOS 16+iPad · iPadOS 16+Mac · macOS 13+Apple Vision · visionOS 1+

Native example

Use Checkbox

Use for an independently selectable Boolean choice. Prefer Toggle when changing the value applies immediately as a setting.

Checkbox rendered in the iPhone simulator Lumen playground
Verified runtime captureiPhone simulator
swift
LumenCheckbox(
    "Share analytics",
    isChecked: $sharesAnalytics
)

Reference

Public API

The primary shared and platform-specific options exposed by LumenCheckbox.

APIValues or typeDefaultDescription
labelStringRequiredProvides the visible and accessible label.
isCheckedBinding<Bool>RequiredStores the controlled checked state.
Binding setter(Boolean) -> UnitRequiredUpdates the controlled state.
descriptionString?nilAdds optional supporting text.
.disabled()BooleanfalseControls native disabled state.

Native behavior

Design and accessibility

When to use it

Use for an independently selectable Boolean choice. Prefer Toggle when changing the value applies immediately as a setting.

Accessibility

The full labeled row is a native checkbox target and exposes checked and disabled state without duplicating the visual indicator.

Shared component

Available on other platforms

React NativeAndroid / Compose
Apple docsSwiftUI package