嵌入页面的滚动选择器。
相对于picker组件，picker-view拥有更强的灵活性。
当需要对自定义选择的弹出方式和UI表现时，往往需要使用picker-view。

属性说明

属性名 类型 默认值 平台差异说明
value Array＜Number＞ 数组中的数字依次表示 picker-view 内的 picker-view-column 选择的第几项（下标从 0 开始），数字大于 picker-view-column 可选项长度时，选择最后一项。
indicator-style String 设置选择器中间选中框的样式
indicator-class String 设置选择器中间选中框的类名 app-nvue和字节跳动小程序不支持
mask-style String 设置蒙层的样式
mask-class String 设置蒙层的类名 app-nvue和字节跳动小程序不支持
@change EventHandle 当滚动选择，value 改变时触发 change 事件，event.detail = {value: value}；value为数组，表示 picker-view 内的 picker-view-column 当前选择的是第几项（下标从 0 开始）
@pickstart eventhandle 当滚动选择开始时候触发事件 微信小程序2.3.1
@pickend eventhandle 当滚动选择结束时候触发事件 微信小程序2.3.1


注意：**其中只可放置 <picker-view-column/> 组件，其他节点不会显示。

picker-view-column

<picker-view /> 的子组件，仅可放置于 <picker-view /> 中，
其子节点的高度会自动设置成与 picker-view 的选中框的高度一致

示例

查看演示
以下示例代码，来自于hello uni-app项目，推荐使用HBuilderX，新建uni-app项目，选择hello uni-app模板，可直接体验完整示例。

  1. <!-- 本示例未包含完整css，获取外链css请参考上文，在hello uni-app项目中查看 -->
  2. <template>
  3.     <view>
  4.         <view class="uni-padding-wrap">
  5.             <view class="uni-title">日期：{{year}}年{{month}}月{{day}}日</view>
  6.         </view>
  7.         <picker-view v-if="visible" :indicator-style="indicatorStyle" :value="value" @change="bindChange">
  8.             <picker-view-column>
  9.                 <view class="item" v-for="(item,index) in years" :key="index">{{item}}年</view>
  10.             </picker-view-column>
  11.             <picker-view-column>
  12.                 <view class="item" v-for="(item,index) in months" :key="index">{{item}}月</view>
  13.             </picker-view-column>
  14.             <picker-view-column>
  15.                 <view class="item" v-for="(item,index) in days" :key="index">{{item}}日</view>
  16.             </picker-view-column>
  17.         </picker-view>
  18.     </view>
  19. </template>
  1. export default {
  2.     data: function () {
  3.         const date = new Date()
  4.         const years = []
  5.         const year = date.getFullYear()
  6.         const months = []
  7.         const month = date.getMonth() + 1
  8.         const days = []
  9.         const day = date.getDate()
  10.         for (let i = 1990; i <= date.getFullYear(); i++) {
  11.             years.push(i)
  12.         }
  13.         for (let i = 1; i <= 12; i++) {
  14.             months.push(i)
  15.         }
  16.         for (let i = 1; i <= 31; i++) {
  17.             days.push(i)
  18.         }
  19.         return {
  20.             title: 'picker-view',
  21.             years,
  22.             year,
  23.             months,
  24.             month,
  25.             days,
  26.             day,
  27.             value: [9999, month - 1, day - 1],
  28.             visible: true,
  29.             indicatorStyle: `height: ${Math.round(uni.getSystemInfoSync().screenWidth/(750/100))}px;`
  30.         }
  31.     },
  32.     methods: {
  33.         bindChange: function (e) {
  34.             const val = e.detail.value
  35.             this.year = this.years[val[0]]
  36.             this.month = this.months[val[1]]
  37.             this.day = this.days[val[2]]
  38.         }
  39.     }
  40. }

picker-view - 图1
Tips

  • 微信小程序端，滚动时在iOS自带振动反馈，可在系统设置 -> 声音与触感 -> 系统触感反馈中关闭
  • 在2.6.3版本以前，如果需要在PC端使用picker-view，需配置H5模版，并引入touch-emulator.js