addressSel

来自于:开发者立即使用

input hide show destroy back

概述

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:

  • 类型:整数类型
  • 描述:类型

    1. type1 只返回province内容;
    2. type2 返回province,city的内容;
    3. type3 返回provincecityarea
  • 默认值:3

  • 取值范围: 1、2或3。

callback(ret)

ret:

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

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

示例代码

  1. var addressSel = api.require('addressSel');
  2. var param = {
  3. x : 0,
  4. y : 0,
  5. w : 0,
  6. h : 0,
  7. type : 3
  8. };
  9. addressSel.input(param, function(ret, err) {
  10. alert(JSON.stringify(ret));
  11. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

hide

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

hide()

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

show

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

show()

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

destroy

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

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

back

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

back(callback(ret))

callback(ret)

ret:

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

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

补充说明

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