跳到主要内容

Picker 滚轮选择器 ​

uni-appH5微信小程序App

跨端滚轮选择器:封装 picker-view,支持单列、多列与级联(树形选项按所选路径动态生成后续列),可选头部 取消/标题/确定 工具栏。

何时使用 ​

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

何时不使用 ​

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

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Picker 滚轮选择器 · uni-app H5 实时运行 新窗口打开

Props ​

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

Events ​

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

示例 ​

单列(城市) ​

vue
<Picker v-model="s" :columns="cityOptions" />

单列带头部(性别) ​

vue
<Picker v-model="s2" title="选择性别" :columns="genderOptions" />

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

vue
<Picker v-model="s3" title="选择配送时段" :columns="deliveryColumns" />

三列日期(年月日) ​

vue
<Picker v-model="s4" title="选择日期" :columns="dateColumns" />

级联(地区) ​

vue
<Picker v-model="s5" cascade title="选择地区" :columns="areaOptions" />

内联模式(无标题栏) ​

vue
<Picker v-model="s6" :columns="payOptions" :height="160" />