citySelector


citySelector提供一个城市选择的浮动窗口组件,通过rd.require('citySelector')调用对象。(注:环信、图片标注、cityselector不可同时使用,否则会引起编译失败)

UI展示
image

方法:

  • show : 打开citySelector窗口
  • remove : 移除citySelector窗口,释放相应的资源
  • hide : 隐藏显示窗口
  • isShowing : 当前窗口是否显示
  • setFrame : 设置显示窗口的位置
  • addClickListener : 设置选择回调监听

对象:

  • Rect : JSON对象,frame参数

回调方法:

show


显示UI

citySelector.show();
说明:

打开citySelector城市选择界面。调用此方法前必须调用addClickListener添加监听。

参数:

返回值:

无返回值

示例代码
var citySelector = rd.require("citySelector");
citySelector.show();

remove


移除UI

citySelector.remove();
说明:

移除citySelector界面,释放资源

参数:

返回值:

无返回值

示例代码
var citySelector = rd.require("citySelector")
citySelector.remove();

hide


隐藏UI

citySelector.hide();
说明:

隐藏citySelector界面,但是不释放资源

参数:

返回值:

无返回值

示例代码
var citySelector = rd.require("citySelector");
citySelector.hide();

isShowing


当前citySelector是否显示

var showing = citySelector.isShowing();
说明:

参数:

返回值:
  • showing: ( Boolean ) 当前citySelector是否显示
示例代码
var citySelector = rd.require("citySelector");
var showing = citySelector.isShowing();

setFrame


设置frame

citySelector.setFrame(rect);
说明:

参数:
  • rect: ( Rect ) 必选 frame,如果width为0,延伸到屏幕右边,如果height为0,延伸到屏幕下面,建议使用屏幕的宽高。
返回值:

无返回值

示例代码
var citySelector = rd.require("citySelector");
citySelector.setFrame({x:0, y:0, width:0, height:0});

addClickListener


设置事件回调

citySelector.addClickListener(callBack);
说明:

参数:
  • callBack: ( CallBack ) 必选 选中城市回调
返回值:

无返回值

示例代码
var citySelector = rd.require("citySelector");
citySelector.addClickListener(function(city){alert(city)});

Rect


JSON对象 frame参数

Rect 
{
    property Number x,
    property Number y,
    property Number width,
    property Number height
}
说明:

坐标系统,左上角为(0,0),位于第四象限

属性:
  • x: ( Number ) x轴开始坐标
  • y: ( Number ) y轴开始坐标
  • width: ( Number ) 如果width为0,延伸到屏幕右边
  • height: ( Number ) 如果height为0,延伸到屏幕下面

CallBack


设置回调监听,通过回调函数传递选中城市

function(city){
alert(city);
}
说明:

参数:
  • city: ( String ) 必选 选择的城市