::: 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
日期:{{data.year}}年{{data.month}}月{{data.day}}日
{{item}}年
{{item}}月
{{item}}日
```
:::
### 参见
- [参见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规范的多列选择组件,适用于地址选择等场景。
- 注意 `` 仅可放置于 ``