Select from application-provided search results with loading, empty, and retry feedback.
Native example
The application supplies filtered results with unique non-null values, owns request cancellation, and clears stale selection after query edits. React Native and Compose selection emit the option label before the selected value; SwiftUI updates bindings directly.
import { useState } from 'react'
import { LumenAutocomplete } from '@santi020k/lumen-react-native'
const projects = [{ value: 'lumen', label: 'Lumen' }, { value: 'studio', label: 'Studio' }]
export function ProjectSearch() {
const [query, setQuery] = useState('')
const [selected, setSelected] = useState<string>()
const matches = projects.filter(option => option.label.toLowerCase().includes(query.toLowerCase()))
return <LumenAutocomplete label="Project" query={query}
onQueryChange={next => { setQuery(next); setSelected(undefined) }}
options={matches} value={selected} onValueChange={setSelected}
emptyLabel="No projects" dismissLabel="Close results" />
}Reference
The primary shared and platform-specific options exposed by LumenAutocomplete.
| API | Values or type | Default | Description |
|---|---|---|---|
| label | string | Required | Names the search field. |
| query / onQueryChange | string / (string) => void | Required | Controls query text; the host filters results. |
| value / onValueChange | string | undefined / (string) => void | undefined / Required | Controls selection; clear stale selection in the query handler. |
| options | readonly LumenAutocompleteOption[] | Required | Unique string values with label, description and disabled state. |
| loading / resultsErrorMessage / onRetry | boolean / string / () => void | false / undefined / undefined | Hides stale results and offers application-owned recovery. |
| loadingLabel / emptyLabel / retryLabel / dismissLabel | string | Loading results / No results / Retry / Close results | Localizes status and result dismissal. |
| ref / TextInput props | LumenTextInputRef / TextInputProps | undefined | Forwards native input focus and supported input options. |
| description / errorMessage | string | undefined | Provides localized supporting copy or host validation. |
| enabled / readOnly | boolean | true / false | Blocks changes without clearing controlled state. |
Native behavior
The application supplies filtered results with unique non-null values, owns request cancellation, and clears stale selection after query edits. React Native and Compose selection emit the option label before the selected value; SwiftUI updates bindings directly.
Preserves native editable dropdown focus, selected and disabled option semantics, and announced loading, empty, and recovery states.
Shared component