picker-view

嵌入页面的滚动选择器

属性名类型说明最低版本
valueNumberArray数组中的数字依次表示 picker-view 内的 picker-view-column 选择的第几项(下标从 0 开始),数字大于 picker-view-column 可选项长度时,选择最后一项。
indicator-styleString设置选择器中间选中框的样式
indicator-classString设置选择器中间选中框的类名
mask-styleString设置蒙层的样式
mask-classString设置蒙层的类名
bindchangeEventHandle当滚动选择,value 改变时触发 change 事件,event.detail = {value: value};value为数组,表示 picker-view 内的 picker-view-column 当前选择的是第几项(下标从 0 开始)
bindpickstartEventHandle当滚动选择开始时候触发事件
bindpickendEventHandle当滚动选择结束时候触发事件
aria-labelString无障碍访问,(属性)元素的额外描述

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

picker-view-column

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

示例代码:

  1. <view>
  2. <view>{{year}}年{{month}}月{{day}}日</view>
  3. <picker-view
  4. indicator-style="height: 50px;"
  5. style="width: 100%; height: 300px;"
  6. value="{{value}}"
  7. bindchange="bindChange"
  8. >
  9. <picker-view-column>
  10. <view qq:for="{{years}}" style="line-height: 50px">{{item}}年</view>
  11. </picker-view-column>
  12. <picker-view-column>
  13. <view qq:for="{{months}}" style="line-height: 50px">{{item}}月</view>
  14. </picker-view-column>
  15. <picker-view-column>
  16. <view qq:for="{{days}}" style="line-height: 50px">{{item}}日</view>
  17. </picker-view-column>
  18. </picker-view>
  19. </view>
  1. const date = new Date()
  2. const years = []
  3. const months = []
  4. const days = []
  5. for (let i = 1990; i <= date.getFullYear(); i++) {
  6. years.push(i)
  7. }
  8. for (let i = 1; i <= 12; i++) {
  9. months.push(i)
  10. }
  11. for (let i = 1; i <= 31; i++) {
  12. days.push(i)
  13. }
  14. Page({
  15. data: {
  16. years,
  17. year: date.getFullYear(),
  18. months,
  19. month: 2,
  20. days,
  21. day: 2,
  22. value: [9999, 1, 1],
  23. },
  24. bindChange(e) {
  25. const val = e.detail.value
  26. this.setData({
  27. year: this.data.years[val[0]],
  28. month: this.data.months[val[1]],
  29. day: this.data.days[val[2]]
  30. })
  31. }
  32. })

picker_view

Tips

  • tip: 滚动时在iOS自带振动反馈,可在系统设置 -> 声音与触感 -> 系统触感反馈中关闭