Picker 滚轮选择
WebH5
内联滚轮选择器。每列一个 scroll-snap 滚轮,滚动停止后按 scrollTop/项高取整更新选中,支持单列与多列。
何时使用
城市、日期、级数有限的一组枚举值选择,移动端滚轮体验。
何时不使用
选项关联联动频繁变化的复杂级联用 Cascader 类组件;桌面端少量选项用 Select。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | (string | number)[] | "undefined" | 每列选中值(v-model);缺省列取该列第一项 |
columns | PickerOption[] | PickerOption[][] | "[]" | 选项:单列数组 { label, value }[],或多列数组的数组 |
title | string | "''" | 头部标题;给定时显示 取消/标题/确定 栏 |
cascade | boolean | false | 级联模式:columns 传根级选项树(选项可带 children),选中上级后按所选 children 动态生成后续列并重置下级;modelValue 为完整路径,选择上级后路径自动补全到最深首子级 |
childrenKey | string | "children" | 级联模式子级字段名;默认 children |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | (string | number)[] | 滚动选中变化时发出新的每列值数组 |
change | (string | number)[] | 同 update:modelValue,语义化别名 |
cancel | void | 点击头部取消按钮 |
confirm | (string | number)[] | 点击头部确定按钮,回传当前每列值 |
示例
单列(城市)
示例加载中…
多列带头部(配送时段)
示例加载中…
单列带头部(性别)
示例加载中…
无标题栏(内联模式)
示例加载中…
三列日期(年月日)
示例加载中…
事件监听
示例加载中…
Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Picker 文档(含手机预览)。