Component registry
Picker
One animated picker for a choice that is not a form select: a sheet from the bottom on a phone, a popover by its chip on a computer, with sections, search past eight rows, an icon and a line per row, and a check that springs in.
Live web demo
Web source: openvibe-shared/ov-picker · OpenVibePicker.open({ anchor, title, rows | sections, value, multi, search, onPick }); a <select> stays OVForms' (ov-forms.js)
Anatomy
- anchorthe chip or button that opened it; focus goes back to it
- titlewhat is being chosen
- searchappears past eight rows; typing finds
- sectionsgroups with a quiet heading
- rowsan icon or the row's initial, its name and a line, a badge
- checkon the chosen row, or several with Done
Props
anchor- element?
title- string
rows- row[]
sections- { title, rows }[]
value- id | id[]
multi- boolean
search- true | false | "auto"
onPick- function
Behavior and accessibility
- States
- closed · open · searching · chosen · several
- Tokens
- color.bg.raised · color.accent · color.text.muted · size.tap
- Keyboard
- Keeps the focused control in view
- Outside tap
- Closes the surface
- Scroll lock
- Locks the page while open
- Reduced motion
- Remove movement; keep the state change.
- Accessibility
- Picker. A dialog: arrows move, Enter picks, typing finds, Escape closes back to the chip; a sheet follows a finger down. At least 44 × 44 dp or pt for every touch action.
Android · Jetpack Compose
A ModalBottomSheet on a phone and an anchored DropdownMenu on a tablet: a search field past eight rows, ListItem rows with a leading icon and supporting text, a trailing check.
Material 3 container: ModalBottomSheet / DropdownMenu
iOS · SwiftUI
A sheet with detents on a phone and a popover on iPad: a searchable List of rows with an icon, a subtitle and a checkmark.
Example definition
{
"schema": "design.component@1",
"name": "picker",
"props": {
"title": "Model",
"search": "auto"
}
}