::: sourceCode ## picker-view > issues: https://issues.dcloud.net.cn/?mid=component.form-component.picker-view.picker-view > 源码: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-form/components/picker-view ::: > 组件类型:UniPickerViewElement 嵌入页面的滚动选择器 ### 兼容性 Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 ### 属性 | 名称 | 类型 | 兼容性 | 描述 | | :- | :- | :-: | :- | | name | string | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: x; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 表单的控件名称,作为键值对的一部分与表单(form组件)一同提交 | | value | number\[\] | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 表单的控件值,作为键值对的一部分与表单(form组件)一同提交 | | indicator-style | string([string.CSSString](/uts/data-type.md#ide-string)) | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 指示器样式 | | indicator-class | string([string.ClassString](/uts/data-type.md#ide-string)) | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android(VDOM): x; Android(Vapor): 5.36; iOS(VDOM): x; iOS(Vapor): 5.36; HarmonyOS(VDOM): 4.61; HarmonyOS(Vapor): 5.36 | 指示器类 | | mask-style | string([string.CSSString](/uts/data-type.md#ide-string)) | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: x; iOS: x; HarmonyOS: 4.61 | 设置蒙层的样式 | | mask-top-style | string([string.CSSString](/uts/data-type.md#ide-string)) | Web: x; 微信小程序: x; 支付宝小程序: x; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 遮罩顶部类 | | mask-bottom-style | string([string.CSSString](/uts/data-type.md#ide-string)) | Web: x; 微信小程序: x; 支付宝小程序: x; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 遮罩底部类 | | mask-class | string([string.ClassString](/uts/data-type.md#ide-string)) | Web: x; 微信小程序: x; 支付宝小程序: x; Android(VDOM): x; Android(Vapor): 5.21; iOS(VDOM): x; iOS(Vapor): 5.11; HarmonyOS: 4.61 | 遮罩类 | | @change | (event: [UniPickerViewChangeEvent](#unipickerviewchangeevent)) => void | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 当滚动选择,value 改变时触发 change 事件,event.detail = {value: value};value为数组,表示 picker-view 内的 picker-view-column 当前选择的是第几项(下标从 0
开始) | | @pickstart | eventhandle | Web: x; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: x; iOS: x; HarmonyOS: x | *(eventhandle)*
当滚动选择开始时候触发事件 | | @pickend | eventhandle | Web: x; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: x; iOS: x; HarmonyOS: x | *(eventhandle)*
当滚动选择结束时候触发事件 | ### 事件 #### UniPickerViewChangeEvent ```mermaid graph LR UniPickerViewChangeEvent -- Extends --> UniCustomEvent<UniPickerViewChangeEventDetail> style UniCustomEvent<UniPickerViewChangeEventDetail> color:#42b983 click UniCustomEvent<UniPickerViewChangeEventDetail> "https://doc.dcloud.net.cn/uni-app-x/component/common.html#unicustomevent" ``` ##### UniPickerViewChangeEventDetail ###### UniPickerViewChangeEventDetail 的属性值 | 名称 | 类型 | 必填 | | :- | :- | :- | | value | Array<number> | 是 | ### 子组件 @children-tags | 子组件 | 兼容性 | | :- | :- | | [picker-view-column](picker-view-column.md) | Web: 4.0; 微信小程序: 4.41; 支付宝小程序: x; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | ### Tips 支付宝小程序动态设置 `picker-view` 指示器样式时可能出现偏移,建议使用静态配置,避免运行时修改指示器样式。 ### 示例 示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/component/picker-view/picker-view.uvue),与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/component/picker-view/picker-view.uvue) ::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/component/picker-view/picker-view > appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/component/picker-view/picker-view >示例 ```vue ``` ::: ### 参见 - [参见uni-app相关文档](https://uniapp.dcloud.io/component/picker-view.html) ::: sourceCode ## picker-view-column > issues: https://issues.dcloud.net.cn/?mid=component.form-component.picker-view.picker-view-column > 源码: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-form/components/picker-view-column ::: 仅可放置于 picker-view 中,其子节点未继承 picker-view 的选中框的高度,需要自己设置高度并居中 ### 兼容性 Web: 4.0; 微信小程序: 4.41; 支付宝小程序: 5.31; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 ### 属性 | 名称 | 类型 | 兼容性 | | :- | :- | :-: | | value | number | 微信小程序: x; 支付宝小程序: x; HarmonyOS(Vapor): 5.0 | ### 参见 - [参见uni-app相关文档](https://uniapp.dcloud.io/component/picker-view.html#picker-view-column) ## tips - picker里如放置较长内容,应该使用list-view而不是scroll-view。 - uni ui的[uni-data-picker](https://ext.dcloud.net.cn/plugin?id=3796),是封装好的弹出式、分列加载的、DataCom规范的多列选择组件,适用于地址选择等场景。 - 注意 `` 仅可放置于 ``