picker

优质

小牛编辑

141浏览

2023-12-01

picker

从底部弹起的滚动选择器，现支持五种选择器，通过 mode 来区分，分别是普通选择器，多列选择器，时间选择器，日期选择器，省市区选择器，默认是普通选择器。

普通选择器：mode = selector

属性名	类型	默认值	说明
range	Array / Object Array	[]	mode 为 selector 或 multiSelector 时，range 有效
range-key	String		当 range 是一个 Object Array 时，通过 range-key 来指定 Object 中 key 的值作为选择器显示内容
value	Number	0	value 的值表示选择了 range 中的第几个（下标从 0 开始）
bindchange	EventHandle		value 改变时触发 change 事件，event.detail = {value: value}
disabled	Boolean	false	是否禁用
bindcancel	EventHandle		取消选择或点遮罩层收起 picker 时触发

多列选择器：mode = multiSelector

属性名	类型	默认值	说明
range	二维Array / 二维Object Array	[]	mode为 selector 或 multiSelector 时，range 有效。二维数组，长度表示多少列，数组的每项表示每列的数据，如[["a","b"], ["c","d"]]
range-key	String		当 range 是一个二维Object Array 时，通过 range-key 来指定 Object 中 key 的值作为选择器显示内容
value	Array	[]	value 每一项的值表示选择了 range 对应项中的第几个（下标从 0 开始）
bindchange	EventHandle		value 改变时触发 change 事件，event.detail = {value: value}
bindcolumnchange	EventHandle		某一列的值改变时触发 columnchange 事件，event.detail = {column: column, value: value}，column 的值表示改变了第几列（下标从0开始），value 的值表示变更值的下标
bindcancel	EventHandle		取消选择时触发
disabled	Boolean	false	是否禁用

时间选择器：mode = time

属性名	类型	默认值	说明
value	String		表示选中的时间，格式为 "hh:mm"
start	String		表示有效时间范围的开始，字符串格式为 "hh:mm"
end	String		表示有效时间范围的结束，字符串格式为 "hh:mm"
bindchange	EventHandle		value 改变时触发 change 事件，event.detail = {value: value}
bindcancel	EventHandle		取消选择时触发
disabled	Boolean	false	是否禁用

时间选择器：mode = date

属性名	类型	默认值	说明
value	String	0	表示选中的日期，格式为 "YYYY-MM-DD"
start	String		表示有效日期范围的开始，字符串格式为 "YYYY-MM-DD"
end	String		表示有效日期范围的结束，字符串格式为 "YYYY-MM-DD"
fields	String	day	有效值 year , month , day，表示选择器的粒度
bindchange	EventHandle		value 改变时触发 change 事件，event.detail = {value: value}
bindcancel	EventHandle		取消选择时触发
disabled	Boolean	false	是否禁用

fields 有效值：

值	说明
year	选择器粒度为年
month	选择器粒度为月份
day	选择器粒度为天

省市区选择器：mode = region

属性名	类型	默认值	说明
value	Array	[]	表示选中的省市区，默认选中每一列的第一个值
custom-item	String		可为每一列的顶部添加一个自定义的项
bindchange	EventHandle		value 改变时触发 change 事件，event.detail = {value: value, code: code, postcode: postcode}，其中字段code是统计用区划代码，postcode 是邮政编码
bindcancel	EventHandle		取消选择时触发
disabled	Boolean	false	是否禁用

示例代码

<!--picker.jxml-->
<view class="page-section">
    <view class="page-section-title">普通选择器</view>
        <picker bindchange="bindPickerChange" value="{{index}}" range="{{array}}">
            <view class="picker">
      当前选择：{{array[index]}}
      </view>
        </picker>
</view>    
<view class="page-section">
    <view class="page-section-title">多列选择器</view>
        <picker mode="multiSelector" bindchange="bindMultiPickerChange" bindcolumnchange="bindMultiPickerColumnChange" value="{{multiIndex}}" range="{{multiArray}}">
            <view class="picker">
      当前选择：{{multiArray[0][multiIndex[0]]}}，{{multiArray[1][multiIndex[1]]}}，{{multiArray[2][multiIndex[2]]}}
      </view>
        </picker>
</view>
<view class="page-section">
    <view class="page-section-title">时间选择器</view>
        <picker mode="time" value="{{time}}" start="09:01" end="21:01" bindchange="bindTimeChange">
            <view class="picker">
      当前选择: {{time}}
      </view>
        </picker>
</view>
<view class="page-section">
    <view class="page-section-title">日期选择器</view>
        <picker mode="date" value="{{date}}" start="2015-09-01" end="2017-09-01" bindchange="bindDateChange">
            <view class="picker">
      当前选择: {{date}}
      </view>
        </picker>
</view>
<view class="page-section">
    <view class="page-section-title">省市区选择器</view>
        <picker mode="region" bindchange="bindRegionChange" value="{{region}}" custom-item="{{customItem}}">
            <view class="picker">
      当前选择：{{region[0]}}，{{region[1]}}，{{region[2]}}
      </view>
        </picker>
</view>

//picker.js
Page({
  data: {
    array: ['美国', '中国', '巴西', '日本'],
    objectArray: [
      {
        id: 0,
        name: '美国'
      },
      {
        id: 1,
        name: '中国'
      },
      {
        id: 2,
        name: '巴西'
      },
      {
        id: 3,
        name: '日本'
      }
    ],
    index: 0,
    multiArray: [['汽车', '自行车'], ['空调', '冰箱', '洗衣机', '手机'], ['面包', '馒头']],
    objectMultiArray: [
      [
        {
          id: 0,
          name: '空调'
        },
        {
          id: 1,
          name: '冰箱'
        }
      ], [
        {
          id: 0,
          name: '啤酒'
        },
        {
          id: 1,
          name: '红酒'
        },
        {
          id: 2,
          name: '白酒'
        },
      ], [
        {
          id: 0,
          name: '矿泉水'
        },
        {
          id: 1,
          name: '可乐'
        }
      ]
    ],
    multiIndex: [0, 0, 0],
    date: '2020-01-01',
    time: '12:01',
    region: ['北京', '北京市', '朝阳区'],
    customItem: '全部'
  },
  bindPickerChange: function(e) {
    console.log('picker change ,值为', e.detail.value)
    this.setData({
      index: e.detail.value
    })
  },
  bindMultiPickerChange: function (e) {
    console.log('picker change ,值为', e.detail.value)
    this.setData({
      multiIndex: e.detail.value
    })
  },
  bindMultiPickerColumnChange: function (e) {
    console.log(e)
  },
  bindDateChange: function(e) {
    console.log('picker change ,值为', e.detail.value)
    this.setData({
      date: e.detail.value
    })
  },
  bindTimeChange: function(e) {
    console.log('picker change ,值为', e.detail.value)
    this.setData({
      time: e.detail.value
    })
  },
  bindRegionChange: function (e) {
    console.log('picker change ,值为', e.detail.value)
    this.setData({
      region: e.detail.value
    })
  }
})