FormsAndroid

Search field

Filter native content with a density-aware search field and clear action.

Public APILumenSearchFieldAndroid / Compose

Native example

Use Search field

Use for filtering an existing collection. Keep search results and empty states close to the field so focus changes remain understandable.

LumenSearchField(
    value = query,
    onValueChange = ::setQuery,
    prompt = "Search workspaces"
)

Reference

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

API	Values or type	Default	Description
prompt	`String`	`Search`	Provides placeholder and field context.
value	`String`	`Required`	Stores the current search query.
onValueChange	`(String) -> Unit`	`Required`	Updates the controlled query.
enabled	`Boolean`	`true`	Controls native disabled presentation.
clearLabel	`String`	`Clear search`	Names the clear action.

Native behavior

Use for filtering an existing collection. Keep search results and empty states close to the field so focus changes remain understandable.

The field uses native text input and provides a labeled clear button whenever text is present.

Shared component