跳到主要内容

Picker 滚轮选择 ​

WebH5

内联滚轮选择器。每列一个 scroll-snap 滚轮,滚动停止后按 scrollTop/项高取整更新选中,支持单列与多列。

何时使用 ​

城市、日期、级数有限的一组枚举值选择,移动端滚轮体验。

何时不使用 ​

选项关联联动频繁变化的复杂级联用 Cascader 类组件;桌面端少量选项用 Select。

Props ​

名称类型默认值说明
modelValue(string | number)[]"undefined"每列选中值(v-model);缺省列取该列第一项
columnsPickerOption[] | PickerOption[][]"[]"选项:单列数组 { label, value }[],或多列数组的数组
titlestring"''"头部标题;给定时显示 取消/标题/确定 栏
cascadebooleanfalse级联模式:columns 传根级选项树(选项可带 children),选中上级后按所选 children 动态生成后续列并重置下级;modelValue 为完整路径,选择上级后路径自动补全到最深首子级
childrenKeystring"children"级联模式子级字段名;默认 children

Events ​

名称载荷说明
update:modelValue(string | number)[]滚动选中变化时发出新的每列值数组
change(string | number)[]同 update:modelValue,语义化别名
cancelvoid点击头部取消按钮
confirm(string | number)[]点击头部确定按钮,回传当前每列值

示例 ​

单列(城市) ​

示例加载中…

多列带头部(配送时段) ​

示例加载中…

单列带头部(性别) ​

示例加载中…

无标题栏(内联模式) ​

示例加载中…

三列日期(年月日) ​

示例加载中…

事件监听 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Picker 文档(含手机预览)。