# picker-view
基础库 1.0.0 开始支持,低版本需做兼容处理。
微信 Windows 版:支持
微信 Mac 版:支持
微信 鸿蒙 OS 版:支持
渲染框架支持情况:Skyline (使用最新 Nighly 工具调试)、WebView
# 功能描述
嵌入页面的滚动选择器。其中只可放置 picker-view-column组件,其它节点不会显示。
目前滚动过程中 bindpickstart、bindpickend 会被触发多次,后续 skyline 升级会修复该问题
# 通用属性
属性 | 类型 | 默认值 | 必填 | 说明 | 最低版本 | |
---|---|---|---|---|---|---|
value | Array.<number> | 否 | 数组中的数字依次表示 picker-view 内的 picker-view-column 选择的第几项(下标从 0 开始),数字大于 picker-view-column 可选项长度时,选择最后一项。 | 1.0.0 | ||
mask-class | string | 否 | 设置蒙层的类名 | 1.5.0 | ||
indicator-style | string | 否 | 设置选择器中间选中框的样式 | 1.0.0 | ||
bindchange | eventhandle | 否 | 滚动选择时触发change事件,event.detail = {value};value为数组,表示 picker-view 内的 picker-view-column 当前选择的是第几项(下标从 0 开始) | 1.0.0 | ||
bindpickstart | eventhandle | 否 | 当滚动选择开始时候触发事件 | 2.3.1 | ||
bindpickend | eventhandle | 否 | 当滚动选择结束时候触发事件 | 2.3.1 |
# WebView 特有属性
属性 | 类型 | 默认值 | 必填 | 说明 | 最低版本 | |
---|---|---|---|---|---|---|
indicator-class | string | 否 | 设置选择器中间选中框的类名 | 1.1.0 | ||
mask-style | string | 否 | 设置蒙层的样式 | 1.5.0 | ||
immediate-change | boolean | false | 否 | 是否在手指松开时立即触发 change 事件。若不开启则会在滚动动画结束后触发 change 事件。 | 2.21.1 |
# Bug & Tip
tip
: 滚动时在iOS自带振动反馈,可在系统设置 -> 声音与触感 -> 系统触感反馈中关闭tip
: indicator-style 属性 skyline 从基础库 ❤️.3.4> 开始支持,目前支持height
、border
、background-color