KVADRANT UI api reference demo

KvadrantListPicker

lists and pickers

tap to expand in place; six or more items go to a page instead

dark
light

mounted as list-picker

why it looks like this

A one-line control that opens into its options — or, past a threshold, into a whole page.

The threshold is five. Up to five items the list expands in place over 200 ms; beyond that the phone navigated to a full page instead, because a list unfolding under your thumb stops being readable somewhere around there. Both numbers are Microsoft's, and the three modes are the control's own: Normal, Expanded, Full.

This composable covers the first two. KvadrantListPickerMode.Full is a navigation decision — it needs somewhere to navigate to — so the control reports it and the caller acts.

Nothing in this repository acts on it yet, which means a picker with six options is a control that cannot be opened at all. Worth knowing before reaching for one: on the phone, Full was the common case — Settings went to a page far more often than anything unfolded in place — so what is built here is the exception. B-30.

Read it: kvadrant-core/src/commonMain/kotlin/io/github/youndie/kvadrant/components/KvadrantListPicker.kt · the full signature and every parameter