citySelector

来自于:官方立即使用

概述

citySelector是一个城市选择器,以选择器的形式将中国各个省市级城市弹出,供用户选择,开发者可自定义该选择器的样式。若想自定义数据源,可用customSelector 模块或者UIActionSelector自定义。

open

打开城市选择器

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

params

y:

  • 类型:数字
  • 描述:(可选项)选择器视图上边缘距离所依附窗口顶部的距离
  • 默认值:所依附窗口高度减244

height:

  • 类型:数字
  • 描述:(可选项)选择器的高度,小于244无效
  • 默认值:244

titleHeight:

  • 类型:数字
  • 描述:(可选项)标题栏高度
  • 默认值:44

cancelImg:

  • 类型:字符串
  • 描述:(可选项)取消按钮的背景图片的路径,要求本地路径(fs、widget)
  • 默认值:默认图标

enterImg:

  • 类型:字符串
  • 描述:(可选项)确定按钮的背景图片的路径(本地),要求本地路径(fs、widget)
  • 默认值:默认图标

titleImg:

  • 类型:字符串
  • 描述:(可选项)选择器顶端导航条背景图片的路径(本地),要求本地路径(fs、widget)
  • 默认值:默认图片

bgImg:

  • 类型:字符串
  • 描述:(可选项)选择器背景图片的路径(本地),要求本地路径(fs、widget)
  • 默认值:默认图片

fontColor:

  • 类型:字符串
  • 描述:(可选项)选择器字体颜色
  • 默认值:#000000

selectedColor:

  • 类型:字符串
  • 描述:(可选项)选中字体颜色
  • 默认值:#8B0000

anim:

  • 类型:布尔
  • 描述:(可选项)是否添加弹出动画
  • 默认值:false

fixedOn:

  • 类型:字符串类型
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
  • 默认:模块依附于当前 window

callback(ret)

ret:

  • 类型:JSON 对象

  • 内部字段:

{
    province:               //选中的省
    city:                        //选中的市
    county                  //选中的县
}

示例代码

var citySelector = api.require('citySelector');
citySelector.open({
    y: api.frameHeight / 1.6,
    fixedOn: api.frameName
}, function(ret) {
    if (ret) {
        alert(JSON.stringify(ret));
    } 
});

可用性

iOS系统,安卓系统

可提供的1.0.0及更高版本

hide

隐藏选择器

隐藏选择器,只是移除到屏幕之外,还在内存里没有清除

hide({params})

params

anim:

  • 类型:布尔
  • 描述:(可选项)是否添加动画
  • 默认值:false

示例代码

var citySelector = api.require('citySelector');
citySelector.hide({
   anim:true
});

可用性

iOS系统,安卓系统

可提供的1.0.1及更高版本

show

显示选择器,从屏幕外移动到屏幕内

show(parmas)

params

anim:

  • 类型:布尔
  • 描述:(可选项)是否添加动画
  • 默认值:false

示例代码

var citySelector = api.require('citySelector');
citySelector.show({
  anim:true
});

可用性

iOS系统,安卓系统

可提供的1.0.1及更高版本

close

关闭选择器,意味着从内存里清除

close(parmas)

params

anim:

  • 类型:布尔
  • 描述:(可选项)是否添加动画
  • 默认值:false

示例代码

var citySelector = api.require('citySelector');
citySelector.close({
   anim:true
});

可用性

iOS系统,安卓系统

可提供的1.0.1及更高版本