citySelector

来自于：官方

Method

open hide show close

概述

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及更高版本