listView

open getIndex close deleteItem insertItem setRefreshHeader hide

概述

listView 封装了一个列表控件，可实现一个可左右拖动item的列表视图。开发者可根据需求自定义列表的数据源，亦可自定义相关字段的样式。支持设置下拉刷新和上拉加载更多事件。UIListView 模块是 listView 模块的优化版，建议使用 UIListView 模块，此模块已停止更新。

open

打开

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

x：

  • 类型：数字
  • 默认值：0
  • 描述：（可选项）列表视图的左上角点的X坐标

y：

  • 类型：数字
  • 默认值：0
  • 描述：（可选项）列表视图的左上角点的Y坐标

w：

  • 类型：数字
  • 默认值：父窗口视图的宽
  • 描述：（可选项）列表视图的宽

h：

  • 类型：数字
  • 默认值：父窗口视图的高
  • 描述：（可选项）列表视图的高

leftBtn：

  • 类型：数组对象
  • 默认值：无
  • 描述：（可选项）往右滑动item露出的按钮组成的数组
  • 备注：不传此参数则表示item不可向右滑动
  • 内部字段：

leftBg：

  • 类型：字符串
  • 默认值：#5cacee
  • 描述：（可选项）往右滑动item露出的视图的背景色

rightBtn：

  • 类型：数组对象
  • 默认值：无
  • 描述：（可选项）往左滑动item露出的按钮组成的数字
  • 备注：不传则表示item不可向左滑动
  • 内部字段：
  2.       bg:               //（可选项）按钮背景色，支持 rgb，rgba，#，默认#388e8e
  3.       title:          //（可选项）按钮标题，字符串类型，默认空字符串
  4.       titleSize:      //（可选项）按钮标题字体大小，数字类型，默认12
  5.       titleColor:      //（可选项）按钮标题颜色，支持 rgb，rgba，#，默认#ffffff，可为空
  6.       highlightColor  //（可选项）按钮选中时的颜色值,支持 rgb，rgba，#，默认无
  7.       icon            //（可选项）按钮标题前图标图片路径，图标大小20*20，默认无，可不传，支持本地协议路径，如widget：//、fs://等
  8.    }]

rightBg：

  • 类型：字符串
  • 默认值：#6c7b8b
  • 描述：（可选项）往左滑动item露出的视图的背景色，支持 rgb，rgba，#

borderColor：

  • 类型：字符串
  • 默认值：#696969
  • 描述：（可选项）每个item之间分割线的颜色，支持 rgb，rgba，#

cellBgColor：

  • 类型：字符串
  • 默认值:#AFEEEE
  • 描述：（可选项）item的背景色，支持 rgb，rgba，#

cellSelectColor：

  • 类型：字符串
  • 默认值：#F5F5F5
  • 描述：（可选项）选中item时的颜色，支持 rgb，rgba，#

cellHeight：

  • 类型：数字
  • 默认值：55
  • 描述：（可选项）每个item的高度

imgHeight：

  • 类型：数字
  • 默认值：(itemHeight-10)
  • 描述：（可选项）头像的高

imgWidth：

  • 类型：数字
  • 默认值：imgHeight
  • 描述：（可选项）头像的宽

placeholderImg：

  • 类型：字符串
  • 默认值：无
  • 描述：（可选项）头像占位图，本地图的地址，支持widget，fs等本地协议
  • 备注：不传则不显示头像，标题和子标题顶头显示

fixedOn：

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

data：

  • 类型：数组对象
  • 默认值：无
  • 描述：列表的数据源
  • 内部字段：
  1. [{
  2.     placeholderImg:        //（可选项）头像,一个本地路径,加载网络图片时显示界面上的图
  3.     img:                    //（可选项）item的头像，支持http,https,widget,fs等本地和网络路径协议，网络图片会被缓存到本地
  4.     title:                  //（可选项）item的标题，若subtitle不传或为空字符串则title上下位置居中显示
  5.     subTitle:               //（可选项）item的子标题，若不传或为空字符串则title上下位置居中显示
  6.     titleLocation           //（可选项）标题在水平线上的位置，取值范围：center,left,right，默认left
  7.     titleSize               //（可选项）标题字体的大小，默认12
  8.     titleColor              //（可选项）标题字体的颜色值，默认#000000，支持 rgb,rgba,#
  9.     subTitleLocation        //（可选项）子标题在水平线上的位置，取值范围：center,left,right默认left
  10.     subTitleSize            //（可选项）子标题字体的大小，默认12
  11.     subTitleColor           //（可选项）子标题字体的颜色值,默认黑色,rgb,rgba,#
  12.     remark                  //（可选项）item右边备注，字符串类型，不传或空字符串则不显示
  13.     arrow                   //（可选项）item右边箭头图标路径，支持widget，fs等本地协议，不传或空字符串则不显示
  14.     rightBtn:   //(可选项)数组对象,往左滑动item露出的按钮信息组成的数组，无默认值，若为空则以open接口内data参数外的rightBtn参数为准，若open接口内data参数外的rightBtn参数和本参数都不传，则不可向左滑动
  15.                 内部字段：
  16.                 [{
  17.                    bg:               //（可选项）按钮背景色，支持 rgb，rgba，#，默认#388e8e
  18.                    title:        //（可选项）按钮标题，字符串类型，默认空字符串
  19.                    titleSize:    //（可选项）按钮标题字体大小，数字类型，默认12
  20.                    titleColor:    //（可选项）按钮标题颜色，支持 rgb，rgba，#，默认#ffffff，可为空
  21.                    highlightColor//（可选项）按钮选中时的颜色值,支持 rgb，rgba，#，默认无
  22.                    icon          //（可选项）按钮标题前图标图片路径，图标大小20*20，默认无，可不传，支持本地协议路径，如widget：//、fs://等
  23.                  }]
  24.     rightSlipDistance:        //（可选项）向左滑动露出右边按钮时，item的滑动距离占item宽的百分比，默认50，取值范围30-100
  25.     leftSlipDistance:        //（可选项）向右滑动露出左边按钮时，item的滑动距离占item宽的百分比，默认50，取值范围30-100
  26. }]

rightSlipDistance：

  • 类型：数字
  • 默认值：50
  • 描述：（可选项）向左滑动露出右边按钮时，item的滑动距离咱item宽的百分比，取值范围30-100

leftSlipDistance：

  • 类型：数字
  • 默认值：50
  • 描述：（可选项）向右滑动露出左边按钮时，item的滑动距离咱item宽的百分比，取值范围30-100

markStyle：

  • 类型：JSON 对象
  • 默认值：见内部字段
  • 描述：（可选项）item右边的arrow，remark样式配置
  • 内部字段：
  1. {
  2.      remarkMargin:   //（可选项）备注距离右边的边距，数字类型，默认10
  3.      remarkColor:    //（可选项）备注距字体颜色，支持 rgb，rgba，#，默认#000000
  4.      remarkSize:     //（可选项）备注字体大小，数字类型，默认16
  5.      arrowSize:      //（可选项）右边图标大小，数字类型，默认30
  6. }

callback(ret, err)

ret：

  • 类型：JSON 对象

内部字段：

  1. {
  2.     eventType:          //事件类型，取值范围如下：
  3.                            rightBtn:       //点击右边按钮
  4.                            leftBtn:        //点击右边按钮
  5.                            content:        //点击的item内容
  6.                            avatar:         //点击的item的头像
  7.                            arrow:          //点击item右边箭头图标事件
  8.                            open:           //打开列表视图渲染加载成功
  9.     index:              //点击某个item或其内部按钮返回其索引
  10.     clickType:          //（deprecated）点击类型，取值范围：0-item；1-右边按钮；2-左边的按钮
  11.     btnIndex:           //点击按钮时返回其索引
  12. }

示例代码

  1. var listView = api.require('listView');
  2. listView.open({
  3.     h: 300,
  4.     leftBtn: [{
  5.         color: '#8B0000',
  6.         title: '左按钮1'
  7.     }, {
  8.         color: '#228B22',
  9.         title: '左按钮2'
  10.     }],
  11.     rightBtn: [{
  12.         color: '#8B0000',
  13.     }, {
  14.         color: '#228B22',
  15.         title: '右按钮2'
  16.     }],
  17.     placeholderImg: 'widget://res/listview.png',
  18.     data: [{
  19.         img: 'http://img1.3lian.com/gif/more/11/201206/a5194ba8c27b17def4a7c5495aba5e32.jpg',
  20.         title: '标题',
  21.         subTitle: '子标题，说明文字。。。。。。'
  22.     }, {
  23.         title: '标题',
  24.         subTitle: '子标题'
  25.     }, {
  26.         title: '标题',
  27.         subTitle: '子标题'
  28.     }, {
  29.         title: '标题',
  30.         subTitle: '子标题'
  31.     }, {
  32.         title: '标题',
  33.         subTitle: '子标题'
  34.     }, {
  35.         title: '标题',
  36.         subTitle: '子标题'
  37.     }, {
  38.         title: '标题',
  39.         subTitle: '子标题'
  40.     }, {
  41.         title: '标题',
  42.         subTitle: '子标题 '
  43.     }, {
  44.         title: '标题',
  45.         subTitle: '子标题'
  46.     }, {
  47.         title: '标题',
  48.         subTitle: '子标题 '
  49.     }, {
  50.         title: '标题',
  51.         subTitle: '子标题'
  52.     }]
  53. }, function(ret, err) {
  54.     if (ret) {
  55.         alert(JSON.stringify(ret));
  56.     } else {
  57.         alert(JSON.stringify(err));
  58.     }
  59. });

补充说明

打开列表视图

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setFrame

重设模块视图的y，和h

setFrame({params})

params

anim：

  • 类型：布尔
  • 默认值：false
  • 描述：改变模块视图的frame时是否添加动画效果,可为空

y：

  • 类型：数字类型
  • 默认值：无
  • 描述：（可选项）重设模块视图的y值
  • 备注：若不传则保持原值不变

h：

  • 类型：数字类型
  • 默认值：无
  • 描述：（可选项）重设模块视图的h值
  • 备注：若不传则保持原值不变

示例代码

  1. var listView = api.require('listView');
  2. listView.setFrame({
  3.     anim: true,
  4.     y: 0
  5. });

补充说明

无

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

getIndex

根据唯一标识查找该item在列表中的下标

getIndex({params}, callBack(ret, err))

params

key：

  • 类型：字符串
  • 默认值：无
  • 描述：唯一标识的key

value：

  • 类型：字符串
  • 默认值：无
  • 描述：每条item数据的唯一标识

callback(ret, err)

  • 类型：JSON 对象

内部字段：

  1. {
  2.     index:              //获取的item的索引
  3.     data：              //当前操作的item的数据，内部字段与open里datas元素一致
  4. }

示例代码

补充说明

无

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setRightButtons

设置侧滑item显示出来按钮

setRightButtons({params})

params

index：

  • 类型：数字
  • 默认值：0
  • 描述：要设置侧滑按钮的item的索引,可为空

rightBtn：

  • 类型：数组对象
  • 默认值：无
  • 描述：(可选项)数组对象,往左滑动item露出的按钮信息组成的数组，
  • 备注：若为不传则以open接口内data参数外的rightBtn参数为准，若open接口内data参数外的rightBtn参数和本参数都不传，则不可向左滑动
  • 内部字段：
  1.    [{
  2.         bg:               //（可选项）按钮背景色，支持 rgb，rgba，#，默认#388e8e
  3.         title:        //（可选项）按钮标题，字符串类型，默认空字符串
  4.         titleSize:    //（可选项）按钮标题字体大小，数字类型，默认12
  5.         titleColor:    //（可选项）按钮标题颜色，支持 rgb，rgba，#，默认#ffffff，可为空
  7.         icon          //（可选项）按钮标题前图标图片路径，图标大小20*20，默认无，可不传，支持本地协议路径，如widget：//、fs://等
  8.    }]

示例代码

  1. var listView = api.require('messageList');
  2. listView.setRightButtons({
  3.     index: 0,
  4.     rightBtn: [{
  5.         bg: '#556B2F', //按钮背景色，支持 rgb，rgba，#，默认#ee8262.
  6.         title: '取消', //按钮名字，字符串类型，默认‘按钮’
  7.         titleSize: 13, //按钮标题大小，默认12
  8.         titleColor: '#000000', // 按钮标题颜色，支持 rgb，rgba，#，默认#ffffff
  9.         selectedColor: '#FFFFFF', //按钮选中时候的颜色值,支持 rgb，rgba，#
  10.         icon: 'widget://image/messageList/delete.png'
  11.     }, {
  12.         bg: '#4EEE94', //按钮背景色，支持 rgb，rgba，#，默认#ee8262.
  13.         title: '取消置顶', //按钮名字，字符串类型，默认‘按钮’
  14.         titleSize: 13, //按钮标题大小，默认12
  15.         titleColor: '#000000', // 按钮标题颜色，支持 rgb，rgba，#，默认#ffffff
  16.         selectedColor: 'ffffff', //按钮选中时候的颜色值,支持 rgb，rgba，#
  17.         icon: 'widget://image/messageList/delete.png'
  18.     }]
  19. });

补充说明

无

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

close

关闭listView

close()

示例代码

  1. var listView = api.require('listView');
  2. listView.close();

无

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

reloadData

刷新列表数据

reloadData({params})

params

data：

  • 类型：数组对象
  • 默认值：无
  • 描述：（可选项）列表数据源，若不传则仅停止下拉刷新状态
  • 内部字段：
  1. [{
  2.     placeholderImg:        //（可选项）头像,一个本地路径,加载网络图片时显示界面上的图
  3.     img:                    //（可选项）item的头像，支持http,https,widget,fs等本地和网络路径协议，网络图片会被缓存到本地
  4.     title:                  //（可选项）item的标题，若subtitle不传或为空字符串则title上下位置居中显示
  5.     subTitle:               //（可选项）item的子标题，若不传或为空字符串则title上下位置居中显示
  6.     titleLocation           //（可选项）标题在水平线上的位置，取值范围：center,left,right，默认left
  7.     titleSize               //（可选项）标题字体的大小，默认12
  8.     titleColor              //（可选项）标题字体的颜色值，默认#000000，支持 rgb,rgba,#
  9.     subTitleLocation        //（可选项）子标题在水平线上的位置，取值范围：center,left,right默认left
  10.     subTitleSize            //（可选项）子标题字体的大小，默认12
  11.     subTitleColor           //（可选项）子标题字体的颜色值,默认黑色,rgb,rgba,#
  12.     remark                  //（可选项）item右边备注，字符串类型，不传或空字符串则不显示
  13.     arrow                   //（可选项）item右边箭头图标路径，支持widget，fs等本地协议，不传或空字符串则不显示
  14.     rightBtn:   //(可选项)数组对象,往左滑动item露出的按钮信息组成的数组，无默认值，若为空则以open接口内data参数外的rightBtn参数为准，若open接口内data参数外的rightBtn参数和本参数都不传，则不可向左滑动
  15.                   内部字段：
  16.                   [{
  17.                       bg:               //（可选项）按钮背景色，支持 rgb，rgba，#，默认#388e8e
  18.                       title:        //（可选项）按钮标题，字符串类型，默认空字符串
  19.                       titleSize:    //（可选项）按钮标题字体大小，数字类型，默认12
  20.                       titleColor:    //（可选项）按钮标题颜色，支持 rgb，rgba，#，默认#ffffff，可为空
  21.                       highlightColor//（可选项）按钮选中时的颜色值,支持 rgb，rgba，#，默认无
  22.                       icon          //（可选项）按钮标题前图标图片路径，图标大小20*20，默认无，可不传，支持本地协议路径，如widget：//、fs://等
  23.                   }]
  24. }]

示例代码

  1. var listView = api.require('listView');
  2. listView.reloadData({
  3.     data: [{
  4.         title: '标题',
  5.         subTitle: '子标题，说明文字'
  6.     }, {
  7.         title: '标题',
  8.         subTitle: '子标题'
  9.     }, {
  10.         title: '标题',
  11.         subTitle: '子标题，说明文字'
  12.     }, {
  13.         title: '标题',
  14.         subTitle: '子标题，说明文字。'
  15.     }, {
  16.         title: '标题',
  17.         subTitle: '子标题'
  18.     }, {
  19.         title: '标题',
  20.         subTitle: '子标题，说明文字'
  21.     }, {
  22.         title: '标题',
  23.         subTitle: '子标题，说明文字'
  24.     }, {
  25.         title: '标题',
  26.         subTitle: '子标题'
  27.     }, {
  28.         title: '标题',
  29.         subTitle: '子标题，说明文字'
  30.     }, {
  31.         title: '标题',
  32.         subTitle: '子标题，说明文字'
  33.     }, {
  34.         title: '标题',
  35.         subTitle: '子标题，说明文字'
  36.     }]
  37. });

补充说明

无

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

deleteItem

删除指定索引的数据

deleteItem({params})

params

index：

  • 类型：数字
  • 默认值：列表最后一条数据的索引
  • 描述：（可选项）要删除的数据的索引

示例代码

  1. var listView = api.require('listView');
  2. listView.deleteItem({
  3.     index: 2
  4. });

补充说明

无

可用性

iOS系统，Android系统

可提供的1.0.1及更高版本

refreshItem

刷新指定index条目的数据

refreshItem({params})

params

index：

  • 类型：数字
  • 默认值：0
  • 描述：（可选项）要刷新数据的item索引下标

data：

  • 类型：JSON 对象
  • 默认值：见内部字段
  • 描述：（可选项）要刷新的item的数据源
  • 内部字段：
  1. {
  2.     placeholderImg:         //（可选项）头像,一个本地路径,加载网络图片时显示界面上的图
  3.     img:                    //（可选项）item的头像，支持http,https,widget,fs等本地和网络路径协议，网络图片会被缓存到本地
  4.     title:                  //（可选项）item的标题，若subtitle不传或为空字符串则title上下位置居中显示
  5.     subTitle:               //（可选项）item的子标题，若不传或为空字符串则title上下位置居中显示
  6.     titleLocation           //（可选项）标题在水平线上的位置，取值范围：center,left,right，默认left
  7.     titleSize               //（可选项）标题字体的大小，默认12
  8.     titleColor              //（可选项）标题字体的颜色值，默认#000000，支持 rgb,rgba,#
  9.     subTitleLocation        //（可选项）子标题在水平线上的位置，取值范围：center,left,right默认left
  10.     subTitleSize            //（可选项）子标题字体的大小，默认12
  11.     subTitleColor           //（可选项）子标题字体的颜色值,默认黑色,rgb,rgba,#
  12.     remark                  //（可选项）item右边备注，字符串类型，不传或空字符串则不显示
  13.     arrow                   //（可选项）item右边箭头图标路径，支持widget，fs等本地协议，不传或空字符串则不显示
  14.     rightBtn:   //(可选项)数组对象,往左滑动item露出的按钮信息组成的数组，无默认值，若为空则以open接口内data参数外的rightBtn参数为准，若open接口内data参数外的rightBtn参数和本参数都不传，则不可向左滑动
  15.                   内部字段：
  16.                       bg:               //（可选项）按钮背景色，支持 rgb，rgba，#，默认#388e8e
  17.                       title:        //（可选项）按钮标题，字符串类型，默认空字符串
  18.                       titleSize:    //（可选项）按钮标题字体大小，数字类型，默认12
  19.                       titleColor:    //（可选项）按钮标题颜色，支持 rgb，rgba，#，默认#ffffff，可为空
  20.                       highlightColor//（可选项）按钮选中时的颜色值,支持 rgb，rgba，#，默认无
  21.                       icon          //（可选项）按钮标题前图标图片路径，图标大小20*20，默认无，可不传，支持本地协议路径，如widget：//、fs://等
  22.                   }]
  23. }

示例代码

补充说明

无

可用性

iOS系统，Android系统

可提供的1.0.1及更高版本

insertItemItem

插入指定索引的数据

insertItemItem({params})

params

index：

  • 类型：数字
  • 默认值：列表最后一条数据的索引
  • 描述：（可选项）要插入的item索引下标

data：

  • 类型：JSON 对象
  • 默认值：见内部字段
  • 描述：数据源
  • 内部字段：
  1. {
  2.     placeholderImg:         //（可选项）头像,一个本地路径,加载网络图片时显示界面上的图
  3.     img:                    //（可选项）item的头像，支持http,https,widget,fs等本地和网络路径协议，网络图片会被缓存到本地
  4.     title:                  //（可选项）item的标题，若subtitle不传或为空字符串则title上下位置居中显示
  5.     subTitle:               //（可选项）item的子标题，若不传或为空字符串则title上下位置居中显示
  6.     titleLocation           //（可选项）标题在水平线上的位置，取值范围：center,left,right，默认left
  7.     titleSize               //（可选项）标题字体的大小，默认12
  8.     titleColor              //（可选项）标题字体的颜色值，默认#000000，支持 rgb,rgba,#
  9.     subTitleLocation        //（可选项）子标题在水平线上的位置，取值范围：center,left,right默认left
  10.     subTitleSize            //（可选项）子标题字体的大小，默认12
  11.     subTitleColor           //（可选项）子标题字体的颜色值,默认黑色,rgb,rgba,#
  12.     remark                  //（可选项）item右边备注，字符串类型，不传或空字符串则不显示
  13.     arrow                   //（可选项）item右边箭头图标路径，支持widget，fs等本地协议，不传或空字符串则不显示
  15.                   内部字段：
  16.                   [{
  17.                       bg:               //（可选项）按钮背景色，支持 rgb，rgba，#，默认#388e8e
  18.                       title:        //（可选项）按钮标题，字符串类型，默认空字符串
  19.                       titleSize:    //（可选项）按钮标题字体大小，数字类型，默认12
  20.                       titleColor:    //（可选项）按钮标题颜色，支持 rgb，rgba，#，默认#ffffff，可为空
  21.                       highlightColor//（可选项）按钮选中时的颜色值,支持 rgb，rgba，#，默认无
  22.                       icon          //（可选项）按钮标题前图标图片路径，图标大小20*20，默认无，可不传，支持本地协议路径，如widget：//、fs://等
  23.                   }]
  24. }

示例代码

  1. var listView = api.require('listView');
  2. listView.insertItem({
  3.     index: 2,
  4.     data: {
  5.         img: 'http://d.hiphotos.baidu.com/image/pic/item/4d086e061d950a7b29a788c209d162d9f2d3c922.jpg ',
  6.         title: '12:00',
  7.         subTitle: 'APICloud粉丝互动会',
  8.         remark: '完成'
  9.     }
  10. });

补充说明

无

可用性

iOS系统，Android系统

可提供的1.0.2及更高版本

appendData

appendData({params})

params

data：

  • 类型：数组对象
  • 默认值：无
  • 描述：（可选项）要拼接到列表的数据源，若不传则仅停止上拉加载更多状态
  • 内部字段：
  1. [{
  2.     placeholderImg:         //（可选项）头像,一个本地路径,加载网络图片时显示界面上的图
  3.     img:                    //（可选项）item的头像，支持http,https,widget,fs等本地和网络路径协议，网络图片会被缓存到本地
  4.     title:                  //（可选项）item的标题，若subtitle不传或为空字符串则title上下位置居中显示
  5.     subTitle:               //（可选项）item的子标题，若不传或为空字符串则title上下位置居中显示
  6.     titleLocation           //（可选项）标题在水平线上的位置，取值范围：center,left,right，默认left
  7.     titleSize               //（可选项）标题字体的大小，默认12
  8.     titleColor              //（可选项）标题字体的颜色值，默认#000000，支持 rgb,rgba,#
  9.     subTitleLocation        //（可选项）子标题在水平线上的位置，取值范围：center,left,right默认left
  10.     subTitleSize            //（可选项）子标题字体的大小，默认12
  11.     subTitleColor           //（可选项）子标题字体的颜色值,默认黑色,rgb,rgba,#
  12.     remark                  //（可选项）item右边备注，字符串类型，不传或空字符串则不显示
  13.     arrow                   //（可选项）item右边箭头图标路径，支持widget，fs等本地协议，不传或空字符串则不显示
  14.     rightBtn:   //(可选项)数组对象,往左滑动item露出的按钮信息组成的数组，无默认值，若为空则以open接口内data参数外的rightBtn参数为准，若open接口内data参数外的rightBtn参数和本参数都不传，则不可向左滑动
  15.                   内部字段：
  16.                   [{
  17.                       bg:               //（可选项）按钮背景色，支持 rgb，rgba，#，默认#388e8e
  18.                       title:        //（可选项）按钮标题，字符串类型，默认空字符串
  19.                       titleSize:    //（可选项）按钮标题字体大小，数字类型，默认12
  20.                       titleColor:    //（可选项）按钮标题颜色，支持 rgb，rgba，#，默认#ffffff，可为空
  21.                       highlightColor//（可选项）按钮选中时的颜色值,支持 rgb，rgba，#，默认无
  22.                       icon          //（可选项）按钮标题前图标图片路径，图标大小20*20，默认无，可不传，支持本地协议路径，如widget：//、fs://等
  23.                   }]
  24. }]
  1. var listView = api.require('listView');
  2. listView.appendData({
  3.     data: [{
  4.         title: '标题',
  5.         subTitle: '子标题，说明文字'
  6.     }, {
  7.         title: '标题',
  8.         subTitle: '子标题'
  9.     }, {
  10.         title: '标题',
  11.         subTitle: '子标题，说明文字'
  12.     }, {
  13.         title: '标题',
  14.         subTitle: '子标题，说明文字。'
  15.     }, {
  16.         title: '标题',
  17.         subTitle: '子标题'
  18.     }, {
  19.         title: '标题',
  20.         subTitle: '子标题，说明文字'
  21.     }, {
  22.         title: '标题',
  23.         subTitle: '子标题，说明文字'
  24.     }, {
  25.         title: '标题',
  26.         subTitle: '子标题'
  27.     }, {
  28.         title: '标题',
  29.         subTitle: '子标题，说明文字'
  30.     }, {
  31.         title: '标题',
  32.         subTitle: '子标题，说明文字'
  33.     }, {
  34.         title: '标题',
  35.         subTitle: '子标题，说明文字'
  36.     }]
  37. });

补充说明

无

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setRefreshHeader

设置下拉刷新

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

params

loadingImg：

  • 类型：字符串
  • 默认值：无
  • 描述：下拉刷新时显示的小箭头的本地图片路径

bgColor：

  • 类型：字符串
  • 默认值：#f5f5f5
  • 描述：（可选项）下拉刷新视图的背景色，支持 rgb，rgba，#

textColor：

  • 类型：字符串
  • 默认值：#8e8e8e
  • 描述：（可选项）提示文字颜色，支持 rgb，rgba，#

textDown：

  • 类型：字符串
  • 默认值：下拉可以刷新…
  • 描述：（可选项）提示文字

textUp：

  • 类型：字符串
  • 默认值：松开开始刷新…
  • 描述：（可选项）提示文字

loadingText:

  • 类型：字符串
  • 描述：（可选项）提示文字
  • 默认值：正在加载…

lastUpdateText:

  • 类型：字符串
  • 描述：（可选项）提示文字
  • 默认值：上次更新时间:

showTime：

  • 类型：布尔值
  • 默认值：true
  • 描述：（可选项）是否显示刷新时间

callback(ret, err)

返回触发刷新的事件

示例代码

  1. var loadingImgae = 'widget://res/listView_arrow.png'; //刷新的小箭头，不可为空
  2. var bgColor = '#F5F5F5'; //下拉刷新的背景颜色 ，有默认值，可为空
  3. var textColor = '#8E8E8E'; //提示语颜色，有默认值，可为空
  4. var textDown = '下拉可以刷新...'; //尚未触发刷新时间的提示语，有默认值，可为空
  5. var textUp = '松开开始刷新...'; //触发刷新事件的提示语，有默认值，可为空
  6. var showTime = true; //是否显示时间，有默认值，可为空
  8. var listView = api.require('listView');
  9. listView.setRefreshHeader({
  10.     loadingImg: loadingImgae,
  11.     bgColor: bgColor,
  12.     textColor: textColor,
  13.     textDown: textDown,
  14.     textUp: textUp,
  15.     showTime: showTime
  16. }, function(ret, err) {
  17.     if (ret) {
  18.         alert(JSON.stringify(ret));
  19.     } else {
  20.         alert(JSON.stringify(err));
  21.     }
  22. });

补充说明

无

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setRefreshFooter

设置上拉加载更多

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

params

loadingImg：

  • 类型：字符串
  • 默认值：无
  • 描述：上拉加载更多时显示的小箭头的本地图片路径

bgColor：

  • 类型：字符串
  • 默认值：#f5f5f5
  • 描述：（可选项）上拉加载更多视图的背景色，支持 rgb，rgba，#

textColor：

  • 类型：字符串
  • 默认值：#8e8e8e
  • 描述：（可选项）提示文字颜色，支持 rgb，rgba，#

textDown：

  • 类型：字符串
  • 默认值：上拉可以加载更多…
  • 描述：（可选项）提示文字

textUp：

  • 类型：字符串
  • 默认值：松开开始加载…
  • 描述：（可选项）提示文字

loadingText:

  • 类型：字符串
  • 描述：（可选项）提示文字
  • 默认值：正在加载…

lastUpdateText:

  • 类型：字符串
  • 描述：（可选项）提示文字
  • 默认值：上次更新时间:

showTime：

  • 类型：布尔值
  • 默认值：true
  • 描述：（可选项）是否显示刷新时间

callback(ret, err)

返回触发加载更多的事件

示例代码

  1. var loadingImgae = 'widget://res/listView_arrow.png'; //刷新的小箭头，不可为空
  2. var bgColor = '#F5F5F5'; //下拉刷新的背景颜色 ，有默认值，可为空
  3. var textColor = '#8E8E8E'; //提示语颜色，有默认值，可为空
  4. var textDown = '下拉可加载更多...'; //尚未触发刷新时间的提示语，有默认值，可为空
  5. var textUp = '松开开始加载...'; //触发刷新事件的提示语，有默认值，可为空
  6. var showTime = true; //是否显示时间，有默认值，可为空        
  7. var listView = api.require('listView');
  8. listView.setRefreshFooter({
  9.     loadingImg: loadingImgae,
  10.     bgColor: bgColor,
  11.     textColor: textColor,
  12.     textDown: textDown,
  13.     textUp: textUp,
  14.     showTime: showTime
  15. }, function(ret, err) {
  16.     if (ret) {
  17.         alert(JSON.stringify(ret));
  18.     } else {
  19.         alert(JSON.stringify(err));
  20.     }
  21. });

补充说明

加载更多的设置

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

hide

隐藏listView

hide()

示例代码

补充说明

隐藏listView，并没有从内存里清除

可用性

iOS系统，Android系统

可提供的1.0.1及更高版本

show

显示listView

show()

示例代码

补充说明

显示已隐藏的列表视图

可用性

iOS系统，Android系统