citylist


cityList为城市列表模块,顶部含有搜索框,右侧含有索引。用户自定义城市列表的数据。通过rd.require('cityList')调用对象。

方法:

对象:

  • cityListStyle : JSON对象 设置cityList视图样式参数。
  • cityListData : 数组对象 设置cityList视图数据源参数。
  • Rect : JSON对象 设置cityList视图边框参数。

回调方法:

setFrame


设置cityList视图边框

custom_cityList.setFrame(rect);        
说明:

cityList视图通过rect设置视图边框。

参数:
  • rect: ( Rect ) 必选 frame,如果width为0,延伸到屏幕右边,如果height为0,延伸到屏幕下面
返回值:

无返回值

示例:
var custom_cityList = rd.require('cityList');
custom_cityList.setFrame({x:0,y:0,width:320,height:480});

setStyle


设置cityList视图样式

custom_cityList.setStyle(style);            
说明:

cityList视图可通过style设置参数。

参数:
  • style: ( cityListStyle ) 必选 设置cityList视图样式参数。
返回值:

无返回值

示例:
var style = {searchBar:{bgColor:'#ff00ff',placeHolder:'搜索城市'},listBg:'#00ffff',index:{bgColor:'#ffff00',color:'#ff00ff'},section:{bgColor:'#ff00ff',color:'#ffff00',size:20},content:{bgColor:'#ffff00',color:'#ff00ff',size:17}};

custom_cityList.setStyle(style);

setData


设置cityList视图数据源

custom_cityList.setData(data);            
说明:

cityList视图可通过data设置数据源。

参数:
  • data: ( cityListData ) 必选 设置cityList视图数据源。
返回值:

无返回值

示例:
var data = [{index:"三明",content:["梅列区","三元区","明溪县"]},{index:"济南",content:["历下区","市中区","槐荫区"]},{index:"威海",content:["环翠区","文登市","荣成市"]},{index:"巴中",content:["巴州区","通江县","南江县"]}];

custom_cityList.setData(data);

addClickListener


添加点击列表的监听

custom_cityList.addClickListener(callback);        
说明:

添加点击列表的监听,通过callback参数设置点击回调函数。

参数:
返回值:

无返回值

示例:
function callback(city) {
    alert(city);
}
custom_cityList.addClickListener(callback);

show


打开cityList视图

custom_cityList.show();            
说明:

打开cityList视图,如果视图是隐藏状态,将会显示视图。

参数:

返回值:

无返回值

示例:
custom_cityList.show();

hide


隐藏显示的cityList视图

custom_cityList.hide();
说明:

只是隐藏显示的cityList视图,并没有从内存里清除。

参数:

返回值:

无返回值

示例:
custom_cityList.hide();

isShowing


判断cityList视图是否显示

var result = custom_cityList.isShowing();
说明:

判断cityList视图是否显示。

参数:

返回值:
  • result: (Boolean) 如果视图显示,返回值为true;如果视图隐藏或者已经移除,返回false。
示例:
var result = custom_cityList.isShowing();

remove


移除cityList视图

custom_cityList.remove();
说明:

移除cityList视图。

参数:

返回值:

无返回值

示例:
custom_cityList.remove();

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,延伸到屏幕下面 仅支持整型

cityListData


设置cityList视图参数

cityListData [
      {
          property String index,
          property Array content
      }
]
说明:

数组对象,用于设置cityList视图参数。包含单个分区的JSON对象。

属性:
  • index: (String ) 必选 视图分区的标题
  • content: (Array) 必选 包含多个城市的内容

cityListStyle


设置cityList视图样式参数

cityListStyle {
  property JSON searchBar
      {
          property String bgColor,
          property String placeHolder
      },
  property String listBg,
  property JSON index
      {
          property String bgColor,
          property String color
      },
  property JSON section
      {
          property String bgColor,
          property String color,
          property Number size
      },
  property JSON content
      {
          property String bgColor,
          property String color,
          property Number size
      }
}
说明:

JSON对象,用于设置cityList视图样式参数。

属性:
  • searchBar: (JSON ) 可选 搜索栏
    • bgColor: (String) 可选 搜索栏背景色
    • placeHolder: (String) 可选 搜索栏占位提示文字
  • listBg : (String ) 可选 列表背景色
  • index : (JSON ) 可选 右侧索引
    • bgColor: (String) 可选 索引背景色
    • color: (String) 可选 索引字体颜色
  • section : (JSON ) 可选 视图分区
    • bgColor: (String) 可选 分区背景色
    • color: (String) 可选 分区字体颜色
    • size: (Number) 可选 分区字体大小
  • content : (JSON ) 可选 视图内容
    • bgColor: (String) 可选 内容背景色
    • color: (String) 可选 内容字体颜色
    • size: (Number) 可选 内容字体大小

cityListCallback


点击cityList视图的回调函数

void cityListCallback( city ) {
}
参数:
  • city: ( String ) 点击城市的名称。
返回值:

无返回值