addressSel

概述

addressSel是一个选择省市区的插件,以在h5页面中插入一个view的形式选择省市区,返回用户选择的省市区内容

input

input方法将view添加到页面中

input({params},callback(ret))

params

x:

  • 类型:整数类型
  • 描述:以左上角为原点 x轴偏移量。
  • 默认值:0
  • 取值范围: 0到屏幕宽。

y:

  • 类型:整数类型
  • 描述:以左上角为原点 y轴偏移量。
  • 默认值:0
  • 取值范围: 0到屏幕宽。

w:

  • 类型:整数类型
  • 描述:view 宽度 。
  • 默认值:宽度满屏
  • 取值范围: 0到屏幕宽。

h:

  • 类型:整数类型
  • 描述:view 高度 。
  • 默认值:高度满屏
  • 取值范围: 0到屏幕宽。

type:

  • 类型:整数类型
  • 描述:类型 type为1 只返回province内容; type为2 返回province,city的内容; type为3 返回province,city,area。
  • 默认值:3
  • 取值范围: 1、2或3。

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    //省份
    province:"{\"regionCode\":\"440000000000\",\"regionId\":\"440000000000\",\"regionInitial\":\"G\",\"regionLevel\":\"1\",\"regionName\":\"广东省\",\"regionPcode\":\"0\"}"
    //市
    city:"{\"regionCode\":\"440600000000\",\"regionId\":\"440600000000\",\"regionInitial\":\"F\",\"regionLevel\":\"2\",\"regionName\":\"佛山市\",\"regionPcode\":\"440000000000\"}"
    //区
    area:"{\"regionCode\":\"440601000000\",\"regionId\":\"440601000000\",\"regionInitial\":\"S\",\"regionLevel\":\"3\",\"regionName\":\"市辖区\",\"regionPcode\":\"440600000000\"}
    "}

regioncode、regionId为百度地图地理编码; regionInitial为名称首字母; regionLevel为地理层级; regionName为名称; regionPcode为所属地区百度地图地理编码。

示例代码

var addressSel  = api.require('addressSel');
var param = {
    x : 0, 
    y : 0,
    w : 0,
    h : 0,
    type : 3
};
addressSel.input(param, function(ret, err) {
    alert(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

hide

隐藏view,已调用input情况下可调用此方法隐藏

hide()

示例代码

var addressSel = api.require('addressSel');
addressSel.hide();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

show

显示隐藏的view,调用input,hide 的情况下将原view对象重新显示,节省内存,无需重新创建

show()

示例代码

var addressSel = api.require('addressSel');
addressSel.show();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

destroy

在不使用此view的情况下销毁释放内存 destroy()

示例代码

var addressSel = api.require('addressSel');
addressSel.destroy();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

back

type为多级的情况下调用此方法一级一级返回,当返回到省级的时候返回返回值继续操作;例:type=2时用户点击省级选择进入市级选择,点击android回退键或者头部返回键调用该方法返回省级,再点击返回返回值back=true,在回调中继续操作。

back(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    back:true //布尔型;true||false,是否返回成功
}

示例代码


var addressSel = api.require('addressSel');
addressSel.back(function(ret) {
            alert(JSON.stringify(ret));
        });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

补充说明

android端注意监听回退键配合back方法实现级别回退。

是否仍需要帮助? 请保持联络!
最后更新于 2024/07/10