picker

2024-06-30 22:20| 来源: 网络整理| 查看: 265

# picker

基础库 1.0.0 开始支持，低版本需做兼容处理。

微信 Windows 版：支持

微信 Mac 版：支持

渲染框架支持情况：Skyline （使用最新 Nighly 工具调试）、WebView

# 功能描述

从底部弹起的滚动选择器。

# 通用属性属性类型默认值必填说明最低版本 header-text string 否选择器的标题，仅安卓可用 2.11.0 mode string selector 否选择器类型 1.0.0 合法值说明 selector 普通选择器 multiSelector 多列选择器 time 时间选择器 date 日期选择器 region 省市区选择器 disabled boolean false 否是否禁用 1.0.0 bindcancel eventhandle 否取消选择时触发 1.9.90

除了上述通用的属性，对于不同的mode，picker拥有不同的属性。

# 普通选择器：mode = selector 属性名类型默认值说明最低版本 range array/object array [] mode 为 selector 或 multiSelector 时，range 有效 range-key string 当 range 是一个 Object Array 时，通过 range-key 来指定 Object 中 key 的值作为选择器显示内容 value number 0 表示选择了 range 中的第几个（下标从 0 开始） bindchange eventhandle value 改变时触发 change 事件，event.detail = {value} # 多列选择器：mode = multiSelector 属性名类型默认值说明最低版本 range array/object array [] mode 为 selector 或 multiSelector 时，range 有效 range-key string 当 range 是一个 Object Array 时，通过 range-key 来指定 Object 中 key 的值作为选择器显示内容 value array [] 表示选择了 range 中的第几个（下标从 0 开始） bindchange eventhandle value 改变时触发 change 事件，event.detail = {value} bindcolumnchange eventhandle 列改变时触发 # 时间选择器：mode = time 属性名类型默认值说明最低版本 value string 表示选中的时间，格式为"hh:mm" start string 表示有效时间范围的开始，字符串格式为"hh:mm" end string 表示有效时间范围的结束，字符串格式为"hh:mm" bindchange eventhandle value 改变时触发 change 事件，event.detail = {value} # 日期选择器：mode = date 属性名类型默认值说明最低版本 value string 当天表示选中的日期，格式为"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}

fields 有效值：

值说明 year 选择器粒度为年 month 选择器粒度为月份 day 选择器粒度为天# 省市区选择器：mode = region 1.4.0 属性名类型默认值说明最低版本 value array [] 表示选中的省市区，默认选中每一列的第一个值 custom-item string 可为每一列的顶部添加一个自定义的项 1.5.0 level string region 选择器层级 2.21.1 bindchange eventhandle value 改变时触发 change 事件，event.detail = {value, code, postcode}，其中字段 code 是统计用区划代码，postcode 是邮政编码

level 的有效值

值说明 province 省级选择器 city 市级选择器 region 区级选择器 sub-district 街道选择器# 示例代码

在开发者工具中预览效果

普通选择器当前选择：{{array[index]}} 多列选择器当前选择：{{multiArray[0][multiIndex[0]]}}，{{multiArray[1][multiIndex[1]]}}，{{multiArray[2][multiIndex[2]]}} 时间选择器当前选择: {{time}} 日期选择器当前选择: {{date}} 省市区选择器当前选择：{{region[0]}}，{{region[1]}}，{{region[2]}} 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: 3, name: '软体动物' }, { id: 4, name: '节肢动物' } ], [ { id: 0, name: '猪肉绦虫' }, { id: 1, name: '吸血虫' } ] ], multiIndex: [0, 0, 0], date: '2016-09-01', time: '12:01', region: ['广东省', '广州市', '海珠区'], customItem: '全部' }, bindPickerChange: function(e) { console.log('picker发送选择改变，携带值为', e.detail.value) this.setData({ index: e.detail.value }) }, bindMultiPickerChange: function (e) { console.log('picker发送选择改变，携带值为', e.detail.value) this.setData({ multiIndex: e.detail.value }) }, bindMultiPickerColumnChange: function (e) { console.log('修改的列为', e.detail.column, '，值为', e.detail.value); var data = { multiArray: this.data.multiArray, multiIndex: this.data.multiIndex }; data.multiIndex[e.detail.column] = e.detail.value; switch (e.detail.column) { case 0: switch (data.multiIndex[0]) { case 0: data.multiArray[1] = ['扁性动物', '线形动物', '环节动物', '软体动物', '节肢动物']; data.multiArray[2] = ['猪肉绦虫', '吸血虫']; break; case 1: data.multiArray[1] = ['鱼', '两栖动物', '爬行动物']; data.multiArray[2] = ['鲫鱼', '带鱼']; break; } data.multiIndex[1] = 0; data.multiIndex[2] = 0; break; case 1: switch (data.multiIndex[0]) { case 0: switch (data.multiIndex[1]) { case 0: data.multiArray[2] = ['猪肉绦虫', '吸血虫']; break; case 1: data.multiArray[2] = ['蛔虫']; break; case 2: data.multiArray[2] = ['蚂蚁', '蚂蟥']; break; case 3: data.multiArray[2] = ['河蚌', '蜗牛', '蛞蝓']; break; case 4: data.multiArray[2] = ['昆虫', '甲壳动物', '蛛形动物', '多足动物']; break; } break; case 1: switch (data.multiIndex[1]) { case 0: data.multiArray[2] = ['鲫鱼', '带鱼']; break; case 1: data.multiArray[2] = ['青蛙', '娃娃鱼']; break; case 2: data.multiArray[2] = ['蜥蜴', '龟', '壁虎']; break; } break; } data.multiIndex[2] = 0; break; } console.log(data.multiIndex); this.setData(data); }, bindDateChange: function(e) { console.log('picker发送选择改变，携带值为', e.detail.value) this.setData({ date: e.detail.value }) }, bindTimeChange: function(e) { console.log('picker发送选择改变，携带值为', e.detail.value) this.setData({ time: e.detail.value }) }, bindRegionChange: function (e) { console.log('picker发送选择改变，携带值为', e.detail.value) this.setData({ region: e.detail.value }) } })

【本文地址】

公司简介

联系我们