解释:从底部弹起的滚动选择器。现支持五种选择器,通过 mode 来区分,分别是时间选择器、日期选择器、普通选择器、多列选择器以及省市区选择器,默认是普通选择器。如需级联选择功能,可使用 Smart UI 组件,详见 cascade 级联。
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
mode | String | selector | 否 | 选择器类型 |
disabled | Boolean | false | 否 | 是否禁用 |
bindcancel | EventHandle | 否 | 取消选择或点击遮罩层收起 picker 时触发 |
除去上述通用属性外,针对不同的 mode,picker 组件还提供有其他不同的属性,详细介绍见下。
值 | 说明 |
---|---|
selector | 普通选择器 |
time | 时间选择器 |
date | 日期选择器 |
multiSelector | 多列选择器 |
region | 省市区选择器 |
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
range | Array/Array. | [] | mode 为 selector 或 multiSelector 时,range 有效 |
range-key | String | 当 range 是一个 Array. | |
value | Number | 0 | value 的值表示选择了 range 中的第几个(下标从 0 开始) |
bindchange | EventHandle | value 改变时触发 change 事件, event.detail = {value: value} |
|
title | String | 选择器标题,建议标题控制在 12 个中文汉字长度内,避免出现截断现象, 截断部分将以 … 形式展示 |
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
value | String | 表示选中的时间,格式为“hh:mm” |
|
start | String | 表示有效时间范围的开始,字符串格式为“hh:mm” |
|
end | String | 表示有效时间范围的结束,字符串格式为“hh:mm” |
|
bindchange | EventHandle | value 改变时触发 change 事件, event.detail = {value: value} |
|
title | String | 选择器标题,建议标题控制在 12 个中文汉字长度内,避免出现截断现象, 截断部分将以 … 形式展示 |
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
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: value} |
|
title | String | 选择器标题,建议标题控制在 12 个中文汉字长度内,避免出现截断现象, 截断部分将以 … 形式展示 |
fields 有效值
值 | 说明 |
---|---|
year | 选择器粒度为年 |
month | 选择器粒度为月 |
day | 选择器粒度为天 |
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
range | Array/Array. | [] | mode 为 selector 或 multiSelector 时, range 有效。二维数组,长度表示多少列,数组的每项表示每列的数据,如[[“a”,”b”], [“c”,”d”]]。 |
range-key | String | 当 range 是一个二维 Array. | |
value | Array | [] | value 每一项的值表示选择了 range 对应项中的第几个(下标从 0 开始) |
bindcolumnchange | EventHandle | 某一列的值改变时触发 columnchange 事件,event.detail = {column: column, value: value} ,column 的值表示改变了第几列(下标从 0 开始),value 的值表示变更值的下标 |
|
bindchange | EventHandle | value 改变时触发 change 事件,event.detail = {value: value} |
|
title | String | 选择器标题,建议标题控制在 12 个中文汉字长度内,避免出现截断现象, 截断部分将以 … 形式展示 |
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
value | Array | [] | 表示选中的省市区,默认选中每一列的第一个值 |
custom-item | String | 可为每一列的顶部添加一个自定义的项 | |
bindchange | EventHandle | value 改变时触发 change 事件,event.detail = {value} ,暂不支持统计用区划代码(code)、邮政编码(postcode) |
|
title | String | 选择器标题,建议标题控制在 12 个中文汉字长度内,避免出现截断现象, 截断部分将以 … 形式展示 |
跳转编辑工具
在开发者工具中打开
在 WEB IDE 中打开
扫码体验
代码示例
请使用百度APP扫码
普通选择器
mode="selector"
value="{{arrIndex}}"
range="{{selector}}"
range-key="name"
title="选择器标题"
bind:change="selectorChange">
请选择: {{selector[arrIndex].name}}
Page({
data: {
selector: [{
id: '1',
name:'选项一'
}, {
id: '2',
name:'选项二'
}, {
id: '3',
name:'选项三'
}],
rangeKey: ['选项一'],
arrIndex: 0
},
selectorChange(e) {
console.log('picker-selector changed,值为', e.detail.value);
this.setData('arrIndex', e.detail.value);
}
});
时间选择器
mode="time"
value="{{time}}"
start="1:01"
end="22:59"
bind:change="timeChange"
disabled="false">
请选择时间: {{time}}
Page({
data: {
time: '12:12'
},
timeChange(e) {
console.log('picker-time changed,值为', e.detail.value);
this.setData(
'time', e.detail.value
);
}
});
日期选择器
mode="date"
value="{{dateDay}}"
bind:change="dateChangeDay"
fields="day">
请选择日期: {{dateDay}}
Page({
data: {
dateDay: '2018-01-05'
},
dateChangeDay(e) {
console.log('picker-date changed,值为', e.detail.value);
this.setData(
'dateDay', e.detail.value
);
}
});
多列选择器
mode="multiSelector"
bindchange="bindMultiPickerChange"
bindcolumnchange="bindMultiPickerColumnChange"
value="{{multiIndex}}"
range="{{multiArray}}"
title="多列选择器">
请选择: {{multiArray[0][multiIndex[0]]}} {{multiArray[1][multiIndex[1]]}} {{multiArray[2][multiIndex[2]]}}
Page({
data: {
multiIndex: [0, 0, 0],
multiArray: [['无脊柱动物', '脊柱动物'], ['扁性动物', '线形动物', '环节动物', '软体动物', '节肢动物'], ['猪肉绦虫', '吸血虫']]
},
bindMultiPickerChange: function (e) {
console.log('picker-multiSelector changed,值为', e.detail.value)
this.setData(
'multiIndex', e.detail.value
);
},
bindMultiPickerColumnChange: function (e) {
console.log('修改的列为', e.detail.column, ',值为', e.detail.value);
var data = {
multiArray: this.getData('multiArray'),
multiIndex: this.getData('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;
}
this.setData('multiArray', data.multiArray);
this.setData('multiIndex', data.multiIndex);
}
});
省市区选择器
mode="region"
bind:change="regionChange"
custom-item="{{customItem}}"
title="地区选择器">
请选择地区: {{regionData[0]}} {{regionData[1]}} {{regionData[2]}}
Page({
data: {
regionData: ['全部', '全部', '全部']
},
regionChange(e) {
this.setData(
'regionData', e.detail.value
);
console.log('picker-time changed,值为', e.detail.value);
}
});
设置禁用
disabled
class="disabled"
value="{{arrIndex}}"
range="{{selector}}"
range-key="name"
disabled>
请选择: {{selector[arrIndex].name}}
取消选择时触发提示
bindcancel
value="{{arrIndex}}"
range="{{selector}}"
range-key="name"
bind:change="selectorChange"
bind:cancel="cancel">
请选择: {{selector[arrIndex].name}}
Page({
data: {
arrIndex: 0,
selector: ['选项一', '选项二', '选项三']
},
selectorChange(e) {
console.log('picker-selector changed,值为', e.detail.value);
this.setData('arrIndex', e.detail.value);
},
cancel() {
swan.showToast({
title: '用户取消选择',
icon: 'none'
});
}
});
Tip:基础库版本 11.15 以下:picker 组件在 iOS 系统中从底部弹出,在安卓系统中从中间弹出。
Tip:基础库版本 11.15 及以上:picker 组件双端都是从底部弹出。
当前文章:创新互联百度小程序教程:picker底部弹起的滚动选择器
文章转载:http://www.shufengxianlan.com/qtweb/news27/429877.html
网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等
声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联