listView


listView,表视图

得到listView的对象

  var listView = rd.require("listView");

常量:

添加数据的方式:

  • listView.ADD_DATA_FROM_HEAD(-1) : 值为 -1 从头部添加数据(下拉刷新后添加数据)
  • listView.ADD_DATA_FROM_ALL(0) : 值为 0 对数据进行整体替换
  • listView.ADD_DATA_FROM_FOOT(1) : 值为 1 从尾部添加数据(上拉加载后添加数据)

listView风格:

  • listView.STYLE_SAMPLE_1(1) : 值为 1 listView的item风格1

    Alt text

  • listView.STYLE_SAMPLE_2(2) : 值为 2 listView的item风格2

Alt text

  • listView.STYLE_SAMPLE_3(3) : 值为 3 listView的item风格3

    Alt text

  • listView.STYLE_SAMPLE_4(4) : 值为 4 listView的item风格4

    Alt text

  • listView.STYLE_SAMPLE_5(5) : 值为 5 listView的item风格5

    Alt text

方法:

对象:

回调方法:

setFrame


设置listView的位置大小

listView.setFrame(rect);
说明:

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

无返回值

示例:
var listView = rd.require("listView");
listView.setFrame({x:0,y:0,width:320,height:300});

setStyle


设置listView的风格。

listView.setStyle('style','color');
说明:

设置listView的风格。

参数:
  • style: ( 风格常量 ) 必选 listView的风格
  • color: ( String ) 必选 listView背景色
返回值:

无返回值

示例:
var listView = rd.require("listView");
listView.setStyle(listView.STYLE_SAMPLE_5,'#FF0000');

show


打开listView窗口。

listView.show();
说明:

打开listView窗口,若listView处于隐藏状态在执行该方法后显示listView。

参数:

返回值:

无返回值

示例:
var listView = rd.require("listView");
listView.show();

setData


设置数据。

listView.setData('type','jsonData');
说明:

设置listView数据。

重要注意事项
参数:
返回值:

无返回值

示例:
var listView = rd.require("listView");

var data = 
[
{
    "image": "res://icon/ic_launcher.png", 
    "data": [
        {
            "text": "1aaaa", 
            "color": "#3300cc", 
            "size": "16"
        }, 
        {
            "text": "1bbbb", 
            "color": "#3300cc", 
            "size": "16"
        }, 
        {
            "text": "1cccc", 
            "color": "#3300cc", 
            "size": "16"
        }
    ]
}, 
{
    "image": "res://icon/ic_launcher.png", 
    "data": [
        {
            "text": "2aaaa", 
            "color": "#fff000", 
            "size": "16"
        }, 
        {
            "text": "2bbbb", 
            "color": "#fff000", 
            "size": "16"
        }, 
        {
            "text": "2cccc", 
            "color": "#fff000", 
            "size": "16"
        }
    ]
}
];

listView.setData(listView.ADD_DATA_FROM_ALL,data);

remove


移除listView窗口,释放相应的资源。

listView.remove();
说明:

移除listView窗口,释放相应的资源。

参数:

返回值:

无返回值

示例:
var listView = rd.require("listView");
listView.remove();

hide


隐藏listView窗口。

listView.hide();
说明:

隐藏listView窗口。

参数:

返回值:

无返回值

示例:
var listView = rd.require("listView");
listView.hide();

addDeleteClickListener


向右滑动item显示删除按键。

listView.addDeleteClickListener(callBack);
说明:

向右滑动item显示删除按键。

重要注意事项
  • 1、请在setData方法执行前使用此方法
  • 2、安卓平台如果出现右滑失效现象,可能是手势冲突问题,请参考window中的addIgnoreArea()方法。在生成listView前加入以下代码:
        var IgnoreParams = {// 区域
           x:0,
           y:0,
           width:rd.screen.resolutionWidth,
           height:rd.screen.resolutionHeight
         };

        rd.window.addIgnoreArea(IgnoreParams);// 忽略系统手势区域
参数:
  • callBack:( selectedItemCB ) 必选 对当前Item进行删除操作。
返回值:

无返回值

示例:
 var listView = rd.require("listView");
 listView.addDeleteClickListener(function deleteCB(index){
              alert("要删除的数据是第+index+行");
              });

addItemClickListener


添加item监听。

listView.addItemClickListener(callBack);
说明:

添加item监听。

参数:
返回值:

无返回值

示例:
 var listView = rd.require("listView");
 listView.addItemClickListener(function secletItem(index){
              alert("选中的数据是第+index+行");
              });

openPullFromHead


打开下拉刷新模式。

listView.openPullFromHead(func);
说明:

打开下拉刷新模式。

参数:
返回值:

无返回值

示例:
 var listView = rd.require("listView");
  var data = 
[
{
    "image": "res://icon/ic_launcher.png", 
    "data": [
        {
            "text": "1aaaa", 
            "color": "#3300cc", 
            "size": "16"
        }, 
        {
            "text": "1bbbb", 
            "color": "#3300cc", 
            "size": "16"
        }, 
        {
            "text": "1cccc", 
            "color": "#3300cc", 
            "size": "16"
        }
    ]
}
]; 

 listView.openPullFromHead(function secletItem(){
       listView.setData(listView.ADD_DATA_FROM_ALL,data);
              });

openPullFromHeadAndFoot


打开下拉刷新、上拉加载模式。

listView.openPullFromHeadAndFoot(func1,func2);
说明:

打开下拉刷新、上拉加载模式。

参数:
返回值:

无返回值

示例:
 var listView = rd.require("listView");
  var data = 
[
{
    "image": "res://icon/ic_launcher.png", 
    "data": [
        {
            "text": "1aaaa", 
            "color": "#3300cc", 
            "size": "16"
        }, 
        {
            "text": "1bbbb", 
            "color": "#3300cc", 
            "size": "16"
        }, 
        {
            "text": "1cccc", 
            "color": "#3300cc", 
            "size": "16"
        }
    ]
}
]; 

 listView.openPullFromHeadAndFoot(function secletItem1(){
               listView.setData(listView.ADD_DATA_FROM_HEAD,data);

              },function secletItem2(){
               listView.setData(listView.ADD_DATA_FROM_FOOT,data);
              });

endRefreshing


下拉刷新、上拉加载完成,取消状态。

listView.endRefreshing();
说明:

下拉刷新、上拉加载完成,取消状态。

参数:

返回值:

无返回值

示例:
var listView = rd.require("listView");
listView.endRefreshing();

isShowing


listView是否是显示状态。

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

listView是否是显示状态。

参数:

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

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,延伸到屏幕下面

listViewData


listView参数.

params
[
   property JSON oneItemData;
]
说明:

listView参数。

属性:

oneItemData


listView一条数据.

{
   property String image;
   property JSON  data; 
}
说明:

listView一条数据。

属性:
  • image: ( String ) 必选(值可为空,此时不显示图片) 显示的图片的协议路径,例如:“res://11.jpg”
  • data: ( detailData ) 必选 显示的数据详情

detailData


数据详情,在 listView.STYLE_SAMPLE_1 风格时仅显示前两条,其余显示三条。

[
{
   property String text;
   property String color;
   property String size;
},
{
   property String text;
   property String color;
   property String size;
},
{
   property String text;
   property String color;
   property String size;
}
];
说明:

数据详情,在 listView.STYLE_SAMPLE_1 风格时仅显示前两条,其余显示三条。

属性:
  • text: ( String ) 必选 显示的文字内容
  • color: ( String ) 可选 显示的文字颜色 默认 黑色
  • size: ( Number ) 可选 显示的文字大小 默认16

selectedItemCB


将要进行相应操作的Item。

function selectedItem(index){
    alert('index');
}
参数:
  • index:( Number ) 必选 选中的Item在数据中所在的位置(从数字0开始)
返回值:

无返回值

示例:
function selectedItem(index){
    alert('index');
}

willDoSomethingCB


将要进行相应操作的回调函数。例如:在该函数内如调用setData方法对listView的数据进行更新

function willDoSomething(){


}
返回值:

无返回值

示例:
function willDoSomething(){
    listView.setData(listView.ADD_DATA_FROM_FOOT,data);

}