概述

chooseCity是一个城市选择器，以列表的形式将中国各个省市级城市列出，供用户选择，开发者可自定义该选择器的数据源。

chooseCity

打开城市选择器

chooseCity({params}, callback(ret, err))

params

province：

• 类型：字符串
• 描述：（可选项）默认选择省份
• 默认值：''

resource

• 类型：字符串
• 描述：（可选项）选择器的数据源文件路径，要求本地路径（widget://、fs://)
• 默认值：默认数据源
• 数据源格式：

 {
   "list": {
     "first": [
       {
         "name": "北京市",
         "second": [
           {
             "name": "北京市",
             "third": [
               "东城区",
               "延庆县"
             ]
           }
         ]
       },
       {
         "name": "天津市",
         "second": [
           {
             "name": "天津市",
             "third": [
               "和平区",
               "蓟  县"
             ]
           }
         ]
       },
       {
         "name": "河北省",
         "second": [
           {
             "name": "石家庄市",
             "third": [
               "长安区",
               "鹿泉市"
             ]
           },
           {
             "name": "唐山市",
             "third": [
               "路南区",
               "迁安市"
             ]
           },
           {
             "name": "秦皇岛市",
             "third": [
               "海港区",
               "卢龙县"
             ]
           },
           {
             "name": "邯郸市",
             "third": [
               "邯山区",
               "武安市"
             ]
           },
           {
             "name": "保定市",
             "third": [
                 "雄县",
                 "涿州市"
             ]
           },
           {
             "name": "张家口",
             "third": [
               "桥东区",
               "崇礼县"
             ]
           }
         ]
       }]
   }
}

callback(ret)

ret：

• 类型：JSON 对象

• 内部字段：

{
  province:'',     //字符串类型；选中的省份
    city:''          //字符串类型；选中的城市
}

示例代码

var mtlCityPicker = api.require('mtlCityPicker');
mtlCityPicker.chooseCity({
    province: '北京市',
}, function(ret) {
    api.alert({msg:JSON.stringify(ret)});
});

可用性

iOS系统，安卓系统

可提供的1.0.0及更高版本