picker-view 嵌入页面的滚动选择器
收藏我的收藏
收藏基础库 1.0.0 开始支持本组件。
picker-view 是嵌入页面的滚动选择器。子组件必须是 picker-view-column。
属性说明
属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
value | number[] | | 是 | 设置选择器中被选中的元素， value[i] 表示 picker-view 内的第 i 个 picker-view-column 选中第 value[i] 项元素（下标从 0 开始）。如果 value[i] 大于 picker-view-colum 可选项长度时，选择最后一项。 | 1.0.0 |
indicator-style | string | | 否 | 设置选择器中选中框的样式。 | 1.0.0 |
indicator-class | string | | 否 | 设置选择器中间选中框的类名。 | 2.61.0 |
mask-style | string | | 否 | 设置蒙层的样式。 | 1.0.0 |
mask-class | string | | 否 | 设置蒙层的类名。 | 2.61.0 |
immediate-change | boolean | false | 否 | 设置是否在手指松开时立即触发 change 事件。若将 immediate-change 设置为 false，则会在滚动动画结束时触发 change 事件。 | 2.61.0 |
bindchange | EventHandle | | 否 | 滚动选择时触发 change 事件回调。 | 1.0.0 |
bindpickstart | EventHandle | | 否 | 当滚动选择开始时触发 pickstart 事件回调。 | 2.61.0 |
bindpickend | EventHandle | | 否 | 当滚动动画结束时触发 pickend 事件回调（在 change 事件回调之后触发）。 | 2.61.0 |
bindchange 事件对象的 detail
object 类型，属性如下：
属性名 | 类型 | 说明 | 最低支持版本 |
value | number[] | value[i] 表示事件触发时， picker-view 内第 i （从 0 开始）个 picker-view-column 选中第 value[i] （从 0 开始）项元素。 | 1.0.0 |
bindpickstart 事件对象的 detail
object 类型，属性如下：
属性名 | 类型 | 说明 | 最低支持版本 |
value | number[] | value[i] 表示事件触发时， picker-view 内第 i （从 0 开始）个 picker-view-column 选中第 value[i] （从 0 开始）项元素。 | 2.61.0 |
bindpickend 事件对象的 detail
object 类型，属性如下：
属性名 | 类型 | 说明 | 最低支持版本 |
value | number[] | value[i] 表示事件触发时， picker-view 内第 i （从 0 开始）个 picker-view-column 选中第 value[i] （从 0 开始）项元素。 | 2.61.0 |
扫码体验
代码示例
Bug & Tip
- •Tip: picker-view-column 的子组件不能是样式设置成
display: inline 或 display: inline-block 的组件；- •Tip: 通过
mask-class、mask-style 设置 mask 的样式无法修改 background-size。
