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方法实现级别回退。