Picker 滚轮选择器
uni-appH5微信小程序App
跨端滚轮选择器:封装 picker-view,支持单列、多列与级联(树形选项按所选路径动态生成后续列),可选头部 取消/标题/确定 工具栏。
何时使用
城市、日期、级数有限的一组枚举值选择,移动端滚轮体验。
何时不使用
选项关联联动频繁变化的复杂级联用 Cascader 类组件;桌面端少量选项用 Select。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | (string | number)[] | "[]" | 每列选中值(v-model),级联模式为完整路径;缺省列取该列第一项 |
columns | PickerOption[] | PickerOption[][] | "[]" | 选项:单列数组 { label, value }[],多列数组的数组,或 cascade 时传入根级选项树(选项可带 children) |
title | string | "''" | 头部标题;给定时显示 取消/标题/确定 栏 |
cascade | boolean | false | 级联模式:columns 传根级选项树(选项可带 children),选中上级后按其 children 动态生成后续列并重置下级;modelValue 为完整路径,选择上级后路径自动补全到最深首子级 |
childrenKey | string | "children" | 级联模式子级字段名;默认 children |
height | number | 220 | 滚轮区高度(px),uni-app 端需显式高度;默认 220 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | (string | number)[] | 滚动选中变化时发出新的每列值数组 |
change | (string | number)[] | 同 update:modelValue,语义化别名 |
cancel | void | 点击头部取消按钮 |
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" />