my.multilevelselect(object object)
主体： 企业支付宝小程序 、 个人支付宝小程序
级联选择器。
可用于多级关联数据（如省市区信息）的选择。
object object
查看示例
| 属性 | 类型 | 默认值 | 必填 | 描述 | |||||
|---|---|---|---|---|---|---|---|---|---|
| title | string | - | 否 | 标题 |
|||||
| list | array | - | 是 | 选择数据列表。 注：数据限制小于 200kb |
|||||
|
|||||||||
| success | function | - | 否 | 调用成功的回调函数 |
|||||
| fail | function | - | 否 | 调用失败的回调函数 |
|||||
| complete | function | - | 否 | 调用结束的回调函数（调用成功、失败都会执行） |
success 回调函数
参数
object res
查看示例
| 属性 | 类型 | 描述 | |||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| result | array | 选择的结果 |
|||||||||||||||||||||||
|
fail 回调的参数为 object，error 属性为错误码，errormessage 属性为错误消息。
| 错误码 | 错误消息 | 凯发app官方网站的解决方案 |
|---|---|---|
| 2 | 参数无效 |
检查入参 list 是否有效。 |
在线示例
代码示例
my.multilevelselect(object object)
success 参数
fail 参数
my.multilevelselect({
title: '多级联选择器',
list: [
{
name: '杭州市',
sublist: [
{
name: '西湖区',
sublist: [{ name: '古翠街道' }, { name: '文新街道' }],
},
{
name: '上城区',
sublist: [{ name: '延安街道' }, { name: '龙翔桥街道' }],
},
],
},
{
name: '北京市',
sublist: [{ name: '东城区' }, { name: '西城区' }],
},
],
success: res => {
my.alert({
title: 'multilevelselect success',
content: res.success ? '已选择: ' json.stringify(res.result) : '未选择',
});
},
fail: error => {
console.error('multilevelselect fail: ', json.stringify(error));
},
});
{
"success": true,
"result": [
{
"name": "杭州市",
"input": {
"name": "杭州市",
"sublist": [
{
"name": "西湖区",
"sublist": [
{
"name": "古翠街道"
},
{
"name": "文新街道"
}
]
},
{
"name": "上城区",
"sublist": [
{
"name": "延安街道"
},
{
"name": "龙翔桥街道"
}
]
}
]
}
},
{
"name": "西湖区",
"input": {
"name": "西湖区",
"sublist": [
{
"name": "古翠街道"
},
{
"name": "文新街道"
}
]
}
},
{
"name": "古翠街道",
"input": {
"name": "古翠街道"
}
}
]
}
{
"error": 2,
"errormessage": "无效参数"
}
-
tip安卓支付宝客户端 10.2.90 之前 list 数据超过 100k 可能导致部分机型上选择器不能弹出，建议控制 list 数据大小。
-
bug如果传入的 list 为 null，ios 10.3.10 以下、安卓 10.2.80 以下会触发 success 回调（res.success 为 false）而非 fail 回调。
q：my.multilevelselect 返回值除了 name 参数外，怎样获取到其他参数（比如 code）？
a：
小程序从基础库 2.9.1 开始支持返回 input 参数，input 参数包含用户选中的所有参数。