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：

  • 类型：整数类型
  • 描述：类型 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/11/18