NavigationAndroid

Tabs

Switch a controlled native content panel from an accessible tab list.

Public APILumenTabsAndroid / Compose

Native example

Use Tabs

Use for two to five peer content views whose panel changes in place. Keep URL history and nested destination navigation in the application router; use Navigation bar for top-level app destinations.

Tabs rendered in the Android phone emulator Lumen playground — Verified runtime captureAndroid phone emulator

LumenTabs(
    label = "Workspace views",
    options = workspaceTabs,
    value = activeTab,
    onValueChange = ::setActiveTab
) { selected ->
    WorkspaceTabPanel(selected)
}

Reference

Public API

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

API	Values or type	Default	Description
label	`String`	`Required`	Names the tab list for assistive technology.
options	`List<LumenSelectionOption>`	`Required`	Provides stable tab values, short labels, and optional disabled state.
value	`String`	`Required`	Stores the active tab.
onValueChange	`(String) -> Unit`	`Required`	Updates controlled tab selection.
content	`Native content view`	`Required`	Renders the active panel while Lumen owns the tab list and panel relationship.

Native behavior

Design and accessibility

When to use it

Use for two to five peer content views whose panel changes in place. Keep URL history and nested destination navigation in the application router; use Navigation bar for top-level app destinations.

Accessibility

Every tab exposes selected and disabled state, the tab list has a readable name, and the active panel is announced when selection changes.

Shared component

Available on other platforms

React Native Apple / SwiftUI