Skip to main content
161

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
Android docs
FormsAndroid

Checkbox

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

Public APILumenCheckboxAndroid / Compose

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 Android phone emulator Lumen playground
Verified runtime captureAndroid phone emulator
kotlin
LumenCheckbox(
    label = "Share analytics",
    checked = sharesAnalytics,
    onCheckedChange = ::setSharesAnalytics
)

Reference

Public API

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

APIValues or typeDefaultDescription
labelStringRequiredProvides the visible and accessible label.
checkedBooleanRequiredStores the controlled checked state.
onCheckedChange(Boolean) -> UnitRequiredUpdates the controlled state.
descriptionString?nilAdds optional supporting text.
enabledBooleantrueControls 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 NativeApple / SwiftUI
Android docsCompose module