UIListMeeting

来自于：官方立即使用

open resetRect close show hide getIndex getDataByIndex setSwipeBtns reloadData deleteItem updateItem insertItem appendData getCount setRefreshHeader setRefreshFooter

概述

UIListMeeting 模块封装了一个数据列表控件，列表项水平侧滑可出现控制按钮；开发者可自定义列表的数据源，及列表的样式，支持列表项的增、删、改、查，支持批量更新、追加数据，支持下拉刷新和上拉加载事件。UIListMeeting 模块是基于 UIListView 模块修改的。UIListView模块的源码开源地址为：https://github.com/apicloudcom/UIListView UIListMeeting - 图1

open

打开 UIListMeeting 模块

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

params

rect：

  • 类型：JSON 对象
  • 描述：（可选项）模块的位置及尺寸
  • 备注：Android 必须传此参数
  • 内部字段：
  1. {
  2.     x: 0,   //（可选项）数字类型；模块左上角的 x 坐标（相对于所属的 Window 或 Frame）；默认值：0
  3.     y: 0,   //（可选项）数字类型；模块左上角的 y 坐标（相对于所属的 Window 或 Frame）；默认值：0
  4.     w: 320, //（可选项）数字类型；模块的宽度；默认值：所属的 Window 或 Frame 的宽度
  5.     h: 480  //（可选项）数字类型；模块的高度；默认值：所属的 Window 或 Frame 的高度
  6. }

data：

  • 类型：数组
  • 描述：列表的数据源，开发者可以在本参数内自定义添加唯一的键值对信息（如：uid: ‘1001’），供 getIndex 使用
  • 内部字段：
  1. [{
  2.     head: '',               //（可选项）字符串类型；头像上的文字，若为空则不显示文字
  3.     headBg: '',             //（可选项）字符串类型；头像背景色，支持rgb、rgba、#；默认：#ff0000
  4.     name: '',               //字符串类型；会议员名字
  5.     title: '',              //字符串类型；会议员职位
  6.     status: '',             //（可选项）字符串类型；状态图标地址，要求本地路径（widget、fs），若不传则不显示
  7.     mark: '',               //（可选项）字符串类型；右侧备注的图标路径，要求本地路径（widget、fs），若不传则不显示
  8.     rightBtns: []           //（可选项）数组类型；列表项向左滑动露出的按钮组，配置某一项的特定按钮组，若不传则显示通用按钮，内部字段同下方 rightBtns 参数
  9. }]

rightBtns：

  • 类型：数组
  • 描述：（可选项）列表项向左滑动露出的按钮组，按钮从右往左排列。注意：配置列表每项的通用按钮，用此参数；若配置某一项的特定按钮，可在 data 数组的指定项传入 rightBtns 参数
  • 内部字段：
  1. [{
  2.     bgColor: '#388e8e', //（可选项）字符串类型；按钮背景色，支持 rgb、rgba、#；默认：'#388e8e'
  3.     activeBgColor: '',  //（可选项）字符串类型；按钮按下时的背景色，支持 rgb、rgba、#；默认：#388e8e
  4.     width: 40,          //（可选项）数字类型；按钮的宽度；默认：40       
  5.     title: '',          //（可选项）字符串类型；按钮标题，水平、垂直居中，若不传则不显示
  6.     titleSize: 12,      //（可选项）数字类型；按钮标题文字大小；默认：12
  7.     titleColor: '#fff', //（可选项）字符串类型；按钮标题文字颜色，支持 rgb、rgba、#；默认：'#ffffff'
  8.     icon: '',           //（可选项）字符串类型；按钮标题前的图标路径（本地路径，支持fs://、widget://），水平、垂直居中，图标为正方形，若不传则不显示
  9.     iconWidth: 20       //（可选项）数字类型；按钮标题前的图标宽度，图标为正方形；默认：20
  10. }]

bounces:

  • 类型：布尔
  • 描述：（可选项）是否开启弹动，android 平台不支持本参数
  • 默认：false

styles:

  • 类型：JSON 对象
  • 描述：（可选项）模块每项的样式
  • 内部字段：
  1. {
  2.     border: {                           //（可选项）JSON 对象；分割线配置
  3.         color: '#696969',               //（可选项）字符串类型；列表分割线的颜色，支持 rgb、rgba、#；默认：'#696969'
  4.         width: 0.5                      //（可选项）数字类型；分割线粗细；默认：0.5
  5.     }
  6.     item: {                             //（可选项）JSON对象；列表项的样式
  7.         bgColor: '#AFEEEE',             //（可选项）字符串类型；列表项的背景色，支持 rgb、rgba、#；默认：'#AFEEEE'
  8.         activeBgColor: '#F5F5F5',       //（可选项）字符串类型；列表项按下时的背景色，支持 rgb、rgba、#；默认：'#F5F5F5'
  9.         height: 50,                     //（可选项）数字类型；列表项的高度；默认：50
  10.         headSize: 30,                   //（可选项）数字类型；头像的大小（直径）；默认：30
  11.         nameSize: 14,                   //（可选项）数字类型；列表项名字文字大小；默认：14
  12.         nameColor: '#000',              //（可选项）字符串类型；列表项名字文字颜色，支持 rgb，rgba，#；默认：'#000000'
  13.          nameWidth: 30,                  // (可选项)字符串类型；名字文本标签的宽度，默认：30
  14.         titleSize: 12,                  //（可选项）数字类型；列表项子职位文字大小；默认：12
  15.         titleColor: '#000',             //（可选项）字符串类型：列表项职位文字颜色，支持 rgb、rgba、#；默认：'#000000' 
  16.          titleWidth: 40,                 // (可选项) 数字类型；标题文本标签的宽度；默认：40
  17.         statusSize: 20,                 //（可选项）数字类型；状态图标的大小（正方形边长）；默认：20
  18.         markSize: 20                    //（可选项）数字类型；备注图标的大小（正方形边长）；默认：20
  19.     }
  20. }

fixedOn：

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

showScrollBar：

  • 类型：布尔
  • 描述：（可选项）是否显示滚动条
  • 默认：true

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     id:1,
  3.     eventType: 'show',  //字符串类型；交互事件类型
  4.                         //取值范围如下：
  5.                          //show（模块加载成功事件）
  6.                         //clickRightBtn（点击侧滑出现的右侧按钮事件）
  7.                         //clickContent（点击列表项的内容事件）
  8.     index: 0,           //数字类型；列表项的索引
  9.     btnIndex: 0         //数字类型；列表项侧滑出现的按钮的索引
  10. }

示例代码

  1. var UIListMeeting = api.require('UIListMeeting');
  2. UIListMeeting.open({
  3.     rect: {
  4.         x: 10,
  5.         y: 20,
  6.         w: api.winWidth-20,
  7.         h: api.frameHeight-170
  8.     },
  9.     data: [{
  10.         uid: '1001',
  11.         head: '华',
  12.         headBg: '#ff0000',
  13.         name: '德华',
  14.         title: '歌手',
  15.         status: 'fs://meeting/ring0.png',
  16.         mark: 'fs://meeting/record0.png'
  17.     }, {
  18.         uid: '1002',
  19.         head: '友',
  20.         headBg: '#ff34b3',
  21.         name: '学友',
  22.         title: '歌手',
  23.         status: 'fs://meeting/ring1.png',
  24.         mark: 'fs://meeting/record1.png'
  25.     }, {
  26.         uid: '1003',
  27.         head: '黎',
  28.         headBg: '#ffd700',
  29.         name: '黎明',
  30.         title: '歌手',
  31.         status: 'fs://meeting/ring2.png',
  32.         mark: 'fs://meeting/record2.png'
  33.     }, {
  34.         uid: '1004',
  35.         head: '成',
  36.         headBg: '#fa8072',
  37.         name: '富成',
  38.         title: '歌手',
  39.         status: 'fs://meeting/ring3.png',
  40.         mark: 'fs://meeting/record3.png'
  41.     }, {
  42.         uid: '1005',
  43.         head: '含',
  44.         headBg: '#ff00ff',
  45.         name: '韩寒',
  46.         title: '粉丝',
  47.         status: 'fs://meeting/ring0.png',
  48.         mark: 'fs://meeting/record0.png'
  49.     }, {
  50.         uid: '1006',
  51.         head: '郭',
  52.         headBg: '#cdcd00',
  53.         name: '敬明',
  54.         title: '粉丝',
  55.         status: 'fs://meeting/ring2.png',
  56.         mark: 'fs://meeting/record2.png'
  57.     }, {
  58.         uid: '1007',
  59.         head: '布',
  60.         headBg: '#a2b5cd',
  61.         name: '布什',
  62.         title: '屌丝',
  63.         status: 'fs://meeting/ring1.png',
  64.         mark: 'fs://meeting/record1.png'
  65.     }, {
  66.         uid: '1008',
  67.         head: '森',
  68.         headBg: '#b8860b',
  69.         name: '小森',
  70.         title: '屌丝',
  71.         status: 'fs://meeting/ring4.png',
  72.         mark: 'fs://meeting/record4.png'
  73.     }],
  74.     rightBtns: [{
  75.         bgColor: '#CD3700',
  76.         activeBgColor: '',
  77.         width: 40,
  78.         title: '删除',
  79.         titleSize: 12,
  80.         titleColor: '#fff',
  81.         icon: '',
  82.         iconWidth: 20
  83.     },{
  84.         bgColor: '#CD950C',
  85.         activeBgColor: '',
  86.         width: 40,
  87.         title: '禁言',
  88.         titleSize: 12,
  89.         titleColor: '#fff',
  90.         icon: '',
  91.         iconWidth: 20
  92.     },{
  93.         bgColor: '#C7C7C7',
  94.         activeBgColor: '',
  95.         width: 40,
  96.         title: '取消',
  97.         titleSize: 12,
  98.         titleColor: '#fff',
  99.         icon: '',
  100.         iconWidth: 20
  101.     }],
  102.     styles: {
  103.         border: {
  104.            color: '#000',
  105.            width: 0.5
  106.         }, 
  107.         item: {
  108.             bgColor: '#F5F5F5',
  109.             activeBgColor: '#ffffff',
  110.             height: 50.0,
  111.             headSize: 30,
  112.             nameSize: 14,
  113.             nameColor: '#000',
  114.             titleSize: 12.0,
  115.             titleColor: '#ff0000',
  116.             statusSize: 20.0,
  117.             markSize: 20,
  118.         }
  119.     },
  120.     fixedOn: api.frameName
  121. }, function(ret, err) {
  122.     if (ret) {
  123.         alert(JSON.stringify(ret));
  124.     } else {
  125.         alert(JSON.stringify(err));
  126.     }
  127. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

resetRect

重设 UIListMeeting 模块的位置和大小（rect）

resetRect({params})

params

id：

  • 类型：数字
  • 描述：(可选项) 要重设的模块的 id,当id不传的时候就重设当前打开的模块。

rect：

  • 类型：JSON 对象
  • 描述：要重设的模块的位置及尺寸
  • 内部字段：
  1. {
  2.     x: 0,   //（可选项）数字类型；模块左上角的 x 坐标（相对于所属的 Window 或 Frame）；默认值：原值
  3.     y: 0,   //（可选项）数字类型；模块左上角的 y 坐标（相对于所属的 Window 或 Frame）；默认值：原值
  4.     w: 320, //（可选项）数字类型；模块的宽度；默认值：原值
  5.     h: 480  //（可选项）数字类型；模块的高度；默认值：原值
  6. }

示例代码

  1. var UIListMeeting = api.require('UIListMeeting');
  2. UIListMeeting.resetRect({
  3.    id:1,
  4.     rect: {
  5.         x: 10,
  6.         y: 20,
  7.         w: api.winWidth-20,
  8.         h: api.frameHeight-170
  9.     }
  10. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

close

关闭数据列表模块

close({params})

params

id：

  • 类型：数字
  • 描述：(可选项)要关闭的模块的 id ,当id不传的时候就关闭当前打开的模块。

示例代码

  1. var UIListMeeting = api.require('UIListMeeting');
  2. UIListMeeting.close({
  3. id: 1
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

show

显示 UIListMeeting 模块

show({params})

params

id：

  • 类型：数字
  • 描述：(可选项)要显示的模块的 id ,当id不传的时候就显示当前打开的模块。

示例代码

  1. var UIListMeeting = api.require('UIListMeeting');
  2. UIListMeeting.show({
  3. id:1
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

hide

隐藏 UIListMeeting 模块

hide({params})

params

id：

  • 类型：数字
  • 描述：(可选项)要隐藏的模块的 id ,当id不传的时候就隐藏当前打开的模块。

示例代码

  1. var UIListMeeting = api.require('UIListMeeting');
  2. UIListMeeting.hide({
  3. id:1
  4. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

getIndex

根据开发者自定义的唯一标识（open 接口的 data 参数中自定义的唯一标识）查找列表项对应的数据

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

params

id：

  • 类型：数字
  • 描述：(可选项)列表项对应的模块的 id ,当id不传的时候就设置当前打开的模块。

key：

  • 类型：字符串
  • 描述：调用 open 接口时，data 参数传入的开发者自定义的唯一标识的 key

value：

  • 类型：字符串
  • 描述：调用 open 接口时，data 参数传入的开发者自定义的唯一标识的 value

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     index: 0,   //数字类型；当前列表项的索引
  3.     data: []    //数组类型；当前列表项的数据，内部字段与 open 时的 data 参数一致
  4. }

示例代码

  1. var UIListMeeting = api.require('UIListMeeting');
  2. UIListMeeting.getIndex({
  3.    id:1,
  4.     key: 'uid',
  5.     value: '1001'
  6. }, function(ret, err) {
  7.     if (ret) {
  8.         alert(JSON.stringify(ret));
  9.     } else {
  10.         alert(JSON.stringify(err));
  11.     }
  12. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

getDataByIndex

根据列表项的索引获取对应的数据

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

params

id：

  • 类型：数字
  • 描述：(可选项)列表项的索引对应的模块的 id ,当id不传的时候就设置当前打开的模块。

index：

  • 类型：数字
  • 描述：（可选项）列表项的索引
  • 默认值：0

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     data: []    //数组类型；当前列表项的数据，内部字段与 open 时的 data 参数一致
  3. }

示例代码

  1. var UIListMeeting = api.require('UIListMeeting');
  2. UIListMeeting.getDataByIndex({
  3.     id:1,
  4.     index: 0
  5. }, function(ret, err) {
  6.     if (ret) {
  7.         alert(JSON.stringify(ret));
  8.     } else {
  9.         alert(JSON.stringify(err));
  10.     }
  11. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setSwipeBtns

设置侧滑显示出来的按钮

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

params

id：

  • 类型：数字
  • 描述：(可选项)列表项侧滑露出的按钮组的模块的 id,当id不传的时候就设置当前打开的模块。

index：

  • 类型：数字
  • 描述：（可选项）列表项的索引
  • 默认值：0

btns：

  • 类型：数组
  • 描述：（可选项）列表项侧滑露出的按钮组
  • 内部字段：
  1. [{
  2.     bgColor: '#388e8e', //（可选项）字符串类型；按钮背景色，支持 rgb、rgba、#；默认：'#388e8e'
  3.     activeBgColor: '',  //（可选项）字符串类型；按钮按下时的背景色，支持 rgb、rgba、#；默认：#388e8e
  4.     width: 40,          //（可选项）数字类型；按钮的宽度；默认：40       
  5.     title: '',          //（可选项）字符串类型；按钮标题，水平、垂直居中，若不传则不显示
  6.     titleSize: 12,      //（可选项）数字类型；按钮标题文字大小；默认：12
  7.     titleColor: '#fff', //（可选项）字符串类型；按钮标题文字颜色，支持 rgb、rgba、#；默认：'#ffffff'
  8.     icon: '',           //（可选项）字符串类型；按钮标题前的图标路径（本地路径，支持fs://、widget://），水平、垂直居中，图标为正方形，若不传则不显示
  9.     iconWidth: 20       //（可选项）数字类型；按钮标题前的图标宽度，图标为正方形；默认：20
  10. }]

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true       //布尔型；true||false
  3. }

示例代码

  1. var UIListMeeting = api.require('UIListMeeting');
  2. UIListMeeting.setSwipeBtns({
  3.     id:1,
  4.     index: 0,
  5.     btns: [{
  6.         bgColor: '#CD3700',
  7.         activeBgColor: '',
  8.         width: 40,
  9.         title: '删除',
  10.         titleSize: 12,
  11.         titleColor: '#fff',
  12.         icon: '',
  13.         iconWidth: 20
  14.     },{
  15.         bgColor: '#CD950C',
  16.         activeBgColor: '',
  17.         width: 40,
  18.         title: '禁言',
  19.         titleSize: 12,
  20.         titleColor: '#fff',
  21.         icon: '',
  22.         iconWidth: 20
  23.     }]
  24. }, function(ret, err) {
  25.     if (ret) {
  26.         alert(JSON.stringify(ret));
  27.     } else {
  28.         alert(JSON.stringify(err));
  29.     }
  30. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

reloadData

刷新列表数据

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

params

id：

  • 类型：数字
  • 描述：(可选项)要刷新列表的模块的 id,当id不传的时候就刷新当前打开的模块。

data：

  • 类型：数组
  • 描述：（可选项）列表的数据源，若不传或传空，仅收起下拉刷新组件
  • 内部字段：
  1. [{
  2.     head: '',               //（可选项）字符串类型；头像上的文字，若为空则不显示文字
  3.     headBg: '',             //（可选项）字符串类型；头像背景色，支持rgb、rgba、#；默认：#ff0000
  4.     name: '',               //字符串类型；会议员名字
  5.     title: '',              //字符串类型；会议员职位
  6.     status: '',             //（可选项）字符串类型；状态图标地址，要求本地路径（widget、fs），若不传则不显示
  7.     mark: '',               //（可选项）字符串类型；右侧备注的图标路径，要求本地路径（widget、fs），若不传则不显示
  8.     rightBtns: []           //（可选项）数组类型；列表项向左滑动露出的按钮组，配置某一项的特定按钮组，若不传则显示通用按钮，内部字段同下方 rightBtns 参数
  9. }]

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true        //布尔型；true||false     
  3. }

示例代码

  1. var UIListMeeting = api.require('UIListMeeting');
  2. UIListMeeting.reloadData({
  3.     id:1,
  4.     data: [{
  5.         uid: '1001',
  6.         head: '华',
  7.         headBg: '#ff0000',
  8.         name: '建华',
  9.         title: '歌手',
  10.         status: 'fs://meeting/ring0.png',
  11.         mark: 'fs://meeting/record0.png'
  12.     }, {
  13.         uid: '1002',
  14.         head: '友',
  15.         headBg: '#ff34b3',
  16.         name: '友朋',
  17.         title: '歌手',
  18.         status: 'fs://meeting/ring1.png',
  19.         mark: 'fs://meeting/record1.png'
  20.     }, {
  21.         uid: '1003',
  22.         head: '黎',
  23.         headBg: '#ffd700',
  24.         name: '王明',
  25.         title: '歌手',
  26.         status: 'fs://meeting/ring2.png',
  27.         mark: 'fs://meeting/record2.png'
  28.     }, {
  29.         uid: '1004',
  30.         head: '成',
  31.         headBg: '#fa8072',
  32.         name: '打成',
  33.         title: '歌手',
  34.         status: 'fs://meeting/ring3.png',
  35.         mark: 'fs://meeting/record3.png'
  36.     }, {
  37.         uid: '1005',
  38.         head: '含',
  39.         headBg: '#ff00ff',
  40.         name: '哲民',
  41.         title: '粉丝',
  42.         status: 'fs://meeting/ring0.png',
  43.         mark: 'fs://meeting/record0.png'
  44.     }, {
  45.         uid: '1006',
  46.         head: '郭',
  47.         headBg: '#cdcd00',
  48.         name: '台明',
  49.         title: '粉丝',
  50.         status: 'fs://meeting/ring2.png',
  51.         mark: 'fs://meeting/record2.png'
  52.     }, {
  53.         uid: '1007',
  54.         head: '布',
  55.         headBg: '#a2b5cd',
  56.         name: '小布',
  57.         title: '屌丝',
  58.         status: 'fs://meeting/ring1.png',
  59.         mark: 'fs://meeting/record1.png'
  60.     }]
  61. }, function(ret) {
  62.     if (ret) {
  63.         alert(JSON.stringify(ret));
  64.     } else {
  65.         alert(JSON.stringify(err));
  66.     }
  67. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

deleteItem

根据索引删除某一条列表的数据

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

params

id：

  • 类型：数字
  • 描述：(可选项)索引删除某一条列表的模块的 id,当id不传的时候就设置当前打开的模块。

index：

  • 类型：数字
  • 描述：（可选项）数据列表的索引
  • 默认值：0

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true       //布尔型；true||false
  3. }

示例代码

  1. var UIListMeeting = api.require('UIListMeeting');
  2. UIListMeeting.deleteItem({
  3.     id:1,
  4.     index: 2
  5. }, function(ret, err) {
  6.     if (ret) {
  7.         alert(JSON.stringify(ret));
  8.     } else {
  9.         alert(JSON.stringify(err));
  10.     }
  11. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

updateItem

根据索引更新某一条列表的数据

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

params

id：

  • 类型：数字
  • 描述：(可选项)根据索引更新某一条列表的模块的 id,当id不传的时候就设置当前打开的模块。

index：

  • 类型：数字
  • 描述：（可选项）数据列表的索引
  • 默认值：0

data：

  • 类型：JSON 对象
  • 描述：列表的数据源
  • 内部字段：
  1. {
  2.     head: '',               //（可选项）字符串类型；头像上的文字，若为空则显示原数据
  3.     headBg: '',             //（可选项）字符串类型；头像背景色，支持rgb、rgba、#，若为空则显示原数据
  4.     name: '',               //字符串类型；会议员名字，若为空则显示原数据
  5.     title: '',              //字符串类型；会议员职位，若为空则显示原数据
  6.     status: '',             //（可选项）字符串类型；状态图标地址，要求本地路径（widget、fs），若为空则显示原数据
  7.     mark: ''               //（可选项）字符串类型；右侧备注的图标路径，要求本地路径（widget、fs），若为空则显示原数据
  8. }

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true     //布尔型；true||false
  3. }

示例代码

  1. var UIListMeeting = api.require('UIListMeeting');
  2. UIListMeeting.updateItem({
  3.     id:1,
  4.     index: 2,
  5.     data: {
  6.         uid: '1002',
  7.         head: '冰',
  8.         headBg: '#a2b5cd',
  9.         name: '冰冰',
  10.         title: '屌丝',
  11.         status: 'fs://meeting/ring0.png',
  12.         mark: 'fs://meeting/record0.png'
  13.     }
  14. }, function(ret, err) {
  15.     if (ret) {
  16.         alert(JSON.stringify(ret));
  17.     } else {
  18.         alert(JSON.stringify(err));
  19.     }
  20. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

insertItem

根据索引向某一条列表插入数据

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

params

id：

  • 类型：数字
  • 描述：(可选项)根据索引更新某一条列表的模块的 id,当id不传的时候就设置当前打开的模块。

index：

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

data：

  • 类型：JSON 对象
  • 描述：列表的数据源
  • 内部字段：
  1. {
  2.     head: '',               //（可选项）字符串类型；头像上的文字，若为空则不显示文字
  3.     headBg: '',             //（可选项）字符串类型；头像背景色，支持rgb、rgba、#；默认：#ff0000
  4.     name: '',               //字符串类型；会议员名字
  5.     title: '',              //字符串类型；会议员职位
  6.     status: '',             //（可选项）字符串类型；状态图标地址，要求本地路径（widget、fs），若不传则不显示
  7.     mark: '',               //（可选项）字符串类型；右侧备注的图标路径，要求本地路径（widget、fs），若不传则不显示
  8.     rightBtns: []           //（可选项）数组类型；列表项向左滑动露出的按钮组，配置某一项的特定按钮组，若不传则显示通用按钮，内部字段同下方 rightBtns 参数
  9. }

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true          //布尔型；true||false
  3. }

示例代码

  1. var UIListMeeting = api.require('UIListMeeting');
  2. UIListMeeting.insertItem({
  3.     id:1,
  4.     index: 2,
  5.     data: {
  6.         uid: '1001',
  7.         head: '鑫',
  8.         headBg: '#ff0000',
  9.         name: '刘鑫',
  10.         title: 'CEO',
  11.         status: 'fs://meeting/ring0.png',
  12.         mark: 'fs://meeting/record0.png'
  13.     }
  14. }, function(ret, err) {
  15.     if (ret) {
  16.         alert(JSON.stringify(ret));
  17.     } else {
  18.         alert(JSON.stringify(err));
  19.     }
  20. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

appendData

向列表末端追加数据

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

params

id：

  • 类型：数字
  • 描述：(可选项)要向列表末端追加的模块的 id,当id不传的时候就设置当前打开的模块。

data：

  • 类型：数组对象
  • 描述：列表的数据源，若不传或传空，仅收起上拉加载组件
  • 内部字段：
  1. [{
  2.     head: '',               //（可选项）字符串类型；头像上的文字，若为空则不显示文字
  3.     headBg: '',             //（可选项）字符串类型；头像背景色，支持rgb、rgba、#；默认：#ff0000
  4.     name: '',               //字符串类型；会议员名字
  5.     title: '',              //字符串类型；会议员职位
  6.     status: '',             //（可选项）字符串类型；状态图标地址，要求本地路径（widget、fs），若不传则不显示
  7.     mark: '',               //（可选项）字符串类型；右侧备注的图标路径，要求本地路径（widget、fs），若不传则不显示
  8.     rightBtns: []           //（可选项）数组类型；列表项向左滑动露出的按钮组，配置某一项的特定按钮组，若不传则显示通用按钮，内部字段同下方 rightBtns 参数
  9. }]

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true        //布尔型；true||false
  3. }

示例代码

  1. var UIListMeeting = api.require('UIListMeeting');
  2. UIListMeeting.appendData({
  3. id:1,
  4. data: [{
  5.         uid: '1011',
  6.         head: '强',
  7.         headBg: '#ff0000',
  8.         name: '小强',
  9.         title: '屌丝',
  10.         status: 'fs://meeting/ring0.png',
  11.         mark: 'fs://meeting/record0.png'
  12.     }, {
  13.         uid: '1012',
  14.         head: '达',
  15.         headBg: '#ff34b3',
  16.         name: '邹达',
  17.         title: 'CT0',
  18.         status: 'fs://meeting/ring1.png',
  19.         mark: 'fs://meeting/record1.png'
  20.     }],
  21. }, function(ret, err) {
  22.     if (ret) {
  23.         alert(JSON.stringify(ret));
  24.     } else {
  25.         alert(JSON.stringify(err));
  26.     }
  27. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

getCount

获取当前列表的总数据量

getCount(callback(ret, err))

params

id：

  • 类型：数字
  • 描述：(可选项)获取当前列表的总数据量的模块的 id,当id不传的时候就设置当前打开的模块。

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     count: 21        //数字类型；当前列表包含的数据总数
  3. }

示例代码

  1. var UIListMeeting = api.require('UIListMeeting');
  2. UIListMeeting.getCount({
  3.  id:1 
  4.  },function(ret) {
  5.     alert(JSON.stringify(ret));
  6. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setRefreshHeader

设置下拉刷新，通过 reloadData 收起下拉刷新组件

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

params

id：

  • 类型：数字
  • 描述：(可选项)要下拉刷新的模块的 id,当id不传的时候就设置当前打开的模块。

loadingImg：

  • 类型：字符串
  • 描述：下拉刷新时显示的小箭头图标的本地路径，要求本地路径（fs://、widget://）

bgColor：

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

textColor：

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

textDown：

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

textUp：

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

showTime：

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

callback(ret, err)

下拉刷新的事件回调

示例代码

  1. var UIListMeeting = api.require('UIListMeeting');
  2. UIListMeeting.setRefreshHeader({
  3.     id:1,
  4.     loadingImg: 'widget://res/UIListMeeting_arrow.png',
  5.     bgColor: '#F5F5F5',
  6.     textColor: '#8E8E8E',
  7.     textDown: '下拉可以刷新...',
  8.     textUp: '松开开始刷新...',
  9.     showTime: true
  10. }, function(ret, err) {
  11.     if (ret) {
  12.         alert(JSON.stringify(ret));
  13.     } else {
  14.         alert(JSON.stringify(err));
  15.     }
  16. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setRefreshFooter

设置上拉加载，通过 appendData 收起上拉加载组件

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

params

id：

  • 类型：数字
  • 描述：(可选项)要上拉加载的模块的 id,当id不传的时候就设置当前打开的模块。

loadingImg：

  • 类型：字符串
  • 描述：上拉加载时显示的小箭头图标的本地路径，要求本地路径（fs://、widget://）

bgColor：

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

textColor：

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

textUp：

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

textDown：

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

showTime：

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

callback(ret, err)

上拉加载的事件回调

示例代码

  1. var UIListMeeting = api.require('UIListMeeting');
  2. UIListMeeting.setRefreshFooter({
  3.     id:1,
  4.     loadingImg: 'widget://res/UIListMeeting_arrow.png',
  5.     bgColor: '#F5F5F5',
  6.     textColor: '#8E8E8E',
  7.     textUp: '上拉加载更多...',
  8.     textDown: '松开开始加载...',
  9.     showTime: true
  10. }, function(ret, err) {
  11.     if (ret) {
  12.         alert(JSON.stringify(ret));
  13.     } else {
  14.         alert(JSON.stringify(err));
  15.     }
  16. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本