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.

All components · Kit documents · Definition as JSON

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"
  }
}

Other components