阅读(510) 赞(1)

支付宝小程序API 级联选择

2020-09-07 15:48:04 更新

my.multiLevelSelect

简介

my.multiLevelSelect 是级联选择功能 API。主要用于选择多级关联数据,比如省市区的信息选择。

示例代码

// API-DEMO page/API/multi-level-select/multi-level-select.json
{
     "defaultTitle": "多级联选择器"
}
<!-- API-DEMO page/API/multi-level-select/multi-level-select.axml-->
<view class="page">
  <view class="page-description">多级联选择器 API</view>
  <view class="page-section">
    <view class="page-section-title">my.multiLevelSelect</view>
    <view class="page-section-demo">
      <button type="primary" onTap="openMultiLevelSelect">多级联选择器</button>
    </view>
  </view>
</view>
// API-DEMO page/API/multi-level-select/multi-level-select.js
Page({
  openMultiLevelSelect() {
    my.multiLevelSelect({
        title: '多级联选择器',//级联选择标题
        list: [
        {
            name: "杭州市",//条目名称
            subList: [
                {
                    name: "西湖区",
                    subList: [
                        {
                            name: "古翠街道"
                        },
                        {
                            name: "文新街道"
                        }
                    ]
                },
                {
                    name: "上城区",
                    subList: [
                        {
                            name: "延安街道"
                        },
                        {
                            name: "龙翔桥街道"
                        }
                    ]
                }
            ]//级联子数据列表
        }],//级联数据列表
        success:(res)=>{
            my.alert({title:JSON.stringify(res)})
        }
    });
  }
})

入参

入参为 Object 类型,属性如下:

属性 类型 必填 描述
title String 否 标题。
list JsonArray 是 选择数据列表。具体对象值参见下方 list 对象表。
success Function 否 调用成功的回调函数。
fail Function 否 调用失败的回调函数。
complete Function 否 调用结束的回调函数(调用成功、失败都会执行)。

list 对象
属性 类型 必填 描述
name String 是 条目名称。
subList JsonArray 否 子条目列表。

success 回调函数

入参为 Object 类型,属性如下:

属性 类型 描述
success Boolean 是否选择完成,取消返回 false。
result JsonArray 选择的结果,如[{“name”:”杭州市”},{“name”:”上城区”},{“name”:”古翠街道”}]。