UIListMeeting

概述

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

open

打开 UIListMeeting 插件

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

params

rect:

  • 类型:JSON 对象
  • 描述:(可选项)插件的位置及尺寸
  • 备注:Android 必须传此参数
  • 内部字段:
{
    x: 0,   //(可选项)数字类型;插件左上角的 x 坐标(相对于所属的 Window 或 Frame);默认值:0
    y: 0,   //(可选项)数字类型;插件左上角的 y 坐标(相对于所属的 Window 或 Frame);默认值:0
    w: 320, //(可选项)数字类型;插件的宽度;默认值:所属的 Window 或 Frame 的宽度
    h: 480  //(可选项)数字类型;插件的高度;默认值:所属的 Window 或 Frame 的高度
}

data:

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

rightBtns:

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

bounces:

  • 类型:布尔
  • 描述:(可选项)是否开启弹动,android 平台不支持本参数
  • 默认:false

styles:

  • 类型:JSON 对象
  • 描述:(可选项)插件每项的样式
  • 内部字段:
{
    border: {                           //(可选项)JSON 对象;分割线配置
        color: '#696969',               //(可选项)字符串类型;列表分割线的颜色,支持 rgb、rgba、#;默认:'#696969'
        width: 0.5                      //(可选项)数字类型;分割线粗细;默认:0.5
    }
    item: {                             //(可选项)JSON对象;列表项的样式
        bgColor: '#AFEEEE',             //(可选项)字符串类型;列表项的背景色,支持 rgb、rgba、#;默认:'#AFEEEE'
        activeBgColor: '#F5F5F5',       //(可选项)字符串类型;列表项按下时的背景色,支持 rgb、rgba、#;默认:'#F5F5F5'
        height: 50,                     //(可选项)数字类型;列表项的高度;默认:50
        headSize: 30,                   //(可选项)数字类型;头像的大小(直径);默认:30
        nameSize: 14,                   //(可选项)数字类型;列表项名字文字大小;默认:14
        nameColor: '#000',              //(可选项)字符串类型;列表项名字文字颜色,支持 rgb,rgba,#;默认:'#000000'
         nameWidth: 30,                  // (可选项)字符串类型;名字文本标签的宽度,默认:30
        titleSize: 12,                  //(可选项)数字类型;列表项子职位文字大小;默认:12
        titleColor: '#000',             //(可选项)字符串类型:列表项职位文字颜色,支持 rgb、rgba、#;默认:'#000000' 
         titleWidth: 40,                 // (可选项) 数字类型;标题文本标签的宽度;默认:40
        statusSize: 20,                 //(可选项)数字类型;状态图标的大小(正方形边长);默认:20
        markSize: 20                    //(可选项)数字类型;备注图标的大小(正方形边长);默认:20
    }
}

fixedOn:

  • 类型:字符串类型
  • 描述:(可选项)插件视图添加到指定 frame 的名字(只指 frame,传 window 无效)
  • 默认:插件依附于当前 window

showScrollBar:

  • 类型:布尔
  • 描述:(可选项)是否显示滚动条
  • 默认:true

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    id:1,
    eventType: 'show',  //字符串类型;交互事件类型
                        //取值范围如下:
                         //show(插件加载成功事件)
                        //clickRightBtn(点击侧滑出现的右侧按钮事件)
                        //clickContent(点击列表项的内容事件)
    index: 0,           //数字类型;列表项的索引
    btnIndex: 0         //数字类型;列表项侧滑出现的按钮的索引
}

示例代码

var UIListMeeting = api.require('UIListMeeting');
UIListMeeting.open({
    rect: {
        x: 10,
        y: 20,
        w: api.winWidth-20,
        h: api.frameHeight-170
    },
    data: [{
        uid: '1001',
        head: '华',
        headBg: '#ff0000',
        name: '德华',
        title: '歌手',
        status: 'fs://meeting/ring0.png',
        mark: 'fs://meeting/record0.png'
    }, {
        uid: '1002',
        head: '友',
        headBg: '#ff34b3',
        name: '学友',
        title: '歌手',
        status: 'fs://meeting/ring1.png',
        mark: 'fs://meeting/record1.png'
    }, {
        uid: '1003',
        head: '黎',
        headBg: '#ffd700',
        name: '黎明',
        title: '歌手',
        status: 'fs://meeting/ring2.png',
        mark: 'fs://meeting/record2.png'
    }, {
        uid: '1004',
        head: '成',
        headBg: '#fa8072',
        name: '富成',
        title: '歌手',
        status: 'fs://meeting/ring3.png',
        mark: 'fs://meeting/record3.png'
    }, {
        uid: '1005',
        head: '含',
        headBg: '#ff00ff',
        name: '韩寒',
        title: '粉丝',
        status: 'fs://meeting/ring0.png',
        mark: 'fs://meeting/record0.png'
    }, {
        uid: '1006',
        head: '郭',
        headBg: '#cdcd00',
        name: '敬明',
        title: '粉丝',
        status: 'fs://meeting/ring2.png',
        mark: 'fs://meeting/record2.png'
    }, {
        uid: '1007',
        head: '布',
        headBg: '#a2b5cd',
        name: '布什',
        title: '屌丝',
        status: 'fs://meeting/ring1.png',
        mark: 'fs://meeting/record1.png'
    }, {
        uid: '1008',
        head: '森',
        headBg: '#b8860b',
        name: '小森',
        title: '屌丝',
        status: 'fs://meeting/ring4.png',
        mark: 'fs://meeting/record4.png'
    }],
    rightBtns: [{
        bgColor: '#CD3700',
        activeBgColor: '',
        width: 40,
        title: '删除',
        titleSize: 12,
        titleColor: '#fff',
        icon: '',
        iconWidth: 20
    },{
        bgColor: '#CD950C',
        activeBgColor: '',
        width: 40,
        title: '禁言',
        titleSize: 12,
        titleColor: '#fff',
        icon: '',
        iconWidth: 20
    },{
        bgColor: '#C7C7C7',
        activeBgColor: '',
        width: 40,
        title: '取消',
        titleSize: 12,
        titleColor: '#fff',
        icon: '',
        iconWidth: 20
    }],
    styles: {
        border: {
           color: '#000',
           width: 0.5
        }, 
        item: {
            bgColor: '#F5F5F5',
            activeBgColor: '#ffffff',
            height: 50.0,
            headSize: 30,
            nameSize: 14,
            nameColor: '#000',
            titleSize: 12.0,
            titleColor: '#ff0000',
            statusSize: 20.0,
            markSize: 20,
        }
    },
    fixedOn: api.frameName
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

resetRect

重设 UIListMeeting 插件的位置和大小(rect)

resetRect({params})

params

id:

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

rect:

  • 类型:JSON 对象
  • 描述:要重设的插件的位置及尺寸
  • 内部字段:
{
    x: 0,   //(可选项)数字类型;插件左上角的 x 坐标(相对于所属的 Window 或 Frame);默认值:原值
    y: 0,   //(可选项)数字类型;插件左上角的 y 坐标(相对于所属的 Window 或 Frame);默认值:原值
    w: 320, //(可选项)数字类型;插件的宽度;默认值:原值
    h: 480  //(可选项)数字类型;插件的高度;默认值:原值
}

示例代码

var UIListMeeting = api.require('UIListMeeting');
UIListMeeting.resetRect({
   id:1,
    rect: {
        x: 10,
        y: 20,
        w: api.winWidth-20,
        h: api.frameHeight-170
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

close

关闭数据列表插件

close({params})

params

id:

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

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

# **show**

显示 UIListMeeting 插件

show({params})

params

id:

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

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

# **hide**

隐藏 UIListMeeting 插件

hide({params})

params

id:

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

示例代码

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

可用性

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 对象
  • 内部字段:
{
    index: 0,   //数字类型;当前列表项的索引
    data: []    //数组类型;当前列表项的数据,内部字段与 open 时的 data 参数一致
}

示例代码

var UIListMeeting = api.require('UIListMeeting');
UIListMeeting.getIndex({
   id:1,
    key: 'uid',
    value: '1001'
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

# **getDataByIndex**

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

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

params

id:

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

index:

  • 类型:数字
  • 描述:(可选项)列表项的索引
  • 默认值:0

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    data: []    //数组类型;当前列表项的数据,内部字段与 open 时的 data 参数一致
}

示例代码

var UIListMeeting = api.require('UIListMeeting');
UIListMeeting.getDataByIndex({
    id:1,
    index: 0
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

# **setSwipeBtns**

设置侧滑显示出来的按钮

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

params

id:

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

index:

  • 类型:数字
  • 描述:(可选项)列表项的索引
  • 默认值:0

btns:

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

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true       //布尔型;true||false
}

示例代码

var UIListMeeting = api.require('UIListMeeting');
UIListMeeting.setSwipeBtns({
    id:1,
    index: 0,
    btns: [{
        bgColor: '#CD3700',
        activeBgColor: '',
        width: 40,
        title: '删除',
        titleSize: 12,
        titleColor: '#fff',
        icon: '',
        iconWidth: 20
    },{
        bgColor: '#CD950C',
        activeBgColor: '',
        width: 40,
        title: '禁言',
        titleSize: 12,
        titleColor: '#fff',
        icon: '',
        iconWidth: 20
    }]
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

# **reloadData**

刷新列表数据

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

params

id:

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

data:

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

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true        //布尔型;true||false     
}

示例代码

var UIListMeeting = api.require('UIListMeeting');
UIListMeeting.reloadData({
    id:1,
    data: [{
        uid: '1001',
        head: '华',
        headBg: '#ff0000',
        name: '建华',
        title: '歌手',
        status: 'fs://meeting/ring0.png',
        mark: 'fs://meeting/record0.png'
    }, {
        uid: '1002',
        head: '友',
        headBg: '#ff34b3',
        name: '友朋',
        title: '歌手',
        status: 'fs://meeting/ring1.png',
        mark: 'fs://meeting/record1.png'
    }, {
        uid: '1003',
        head: '黎',
        headBg: '#ffd700',
        name: '王明',
        title: '歌手',
        status: 'fs://meeting/ring2.png',
        mark: 'fs://meeting/record2.png'
    }, {
        uid: '1004',
        head: '成',
        headBg: '#fa8072',
        name: '打成',
        title: '歌手',
        status: 'fs://meeting/ring3.png',
        mark: 'fs://meeting/record3.png'
    }, {
        uid: '1005',
        head: '含',
        headBg: '#ff00ff',
        name: '哲民',
        title: '粉丝',
        status: 'fs://meeting/ring0.png',
        mark: 'fs://meeting/record0.png'
    }, {
        uid: '1006',
        head: '郭',
        headBg: '#cdcd00',
        name: '台明',
        title: '粉丝',
        status: 'fs://meeting/ring2.png',
        mark: 'fs://meeting/record2.png'
    }, {
        uid: '1007',
        head: '布',
        headBg: '#a2b5cd',
        name: '小布',
        title: '屌丝',
        status: 'fs://meeting/ring1.png',
        mark: 'fs://meeting/record1.png'
    }]
}, function(ret) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

# **deleteItem**

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

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

params

id:

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

index:

  • 类型:数字
  • 描述:(可选项)数据列表的索引
  • 默认值:0

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true       //布尔型;true||false
}

示例代码

var UIListMeeting = api.require('UIListMeeting');
UIListMeeting.deleteItem({
    id:1,
    index: 2
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

# **updateItem**

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

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

params

id:

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

index:

  • 类型:数字
  • 描述:(可选项)数据列表的索引
  • 默认值:0

data:

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

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true     //布尔型;true||false
}

示例代码

var UIListMeeting = api.require('UIListMeeting');
UIListMeeting.updateItem({
    id:1,
    index: 2,
    data: {
        uid: '1002',
        head: '冰',
        headBg: '#a2b5cd',
        name: '冰冰',
        title: '屌丝',
        status: 'fs://meeting/ring0.png',
        mark: 'fs://meeting/record0.png'
    }
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

# **insertItem**

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

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

params

id:

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

index:

  • 类型:数字
  • 描述:(可选项)数据列表的索引
  • 默认值:列表最后一条数据的索引

data:

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

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true          //布尔型;true||false
}

示例代码

var UIListMeeting = api.require('UIListMeeting');
UIListMeeting.insertItem({
    id:1,
    index: 2,
    data: {
        uid: '1001',
        head: '鑫',
        headBg: '#ff0000',
        name: '刘鑫',
        title: 'CEO',
        status: 'fs://meeting/ring0.png',
        mark: 'fs://meeting/record0.png'
    }
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

# **appendData**

向列表末端追加数据

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

params

id:

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

data:

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

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true        //布尔型;true||false
}

示例代码

var UIListMeeting = api.require('UIListMeeting');
UIListMeeting.appendData({
id:1,
data: [{
        uid: '1011',
        head: '强',
        headBg: '#ff0000',
        name: '小强',
        title: '屌丝',
        status: 'fs://meeting/ring0.png',
        mark: 'fs://meeting/record0.png'
    }, {
        uid: '1012',
        head: '达',
        headBg: '#ff34b3',
        name: '邹达',
        title: 'CT0',
        status: 'fs://meeting/ring1.png',
        mark: 'fs://meeting/record1.png'
    }],
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

# **getCount**

获取当前列表的总数据量

getCount(callback(ret, err))

params

id:

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

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    count: 21        //数字类型;当前列表包含的数据总数
}

示例代码

var UIListMeeting = api.require('UIListMeeting');
UIListMeeting.getCount({
 id:1 
 },function(ret) {
    api.alert({
            msg: JSON.stringify(ret)
        })
});

可用性

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)

下拉刷新的事件回调

示例代码

var UIListMeeting = api.require('UIListMeeting');
UIListMeeting.setRefreshHeader({
    id:1,
    loadingImg: 'widget://res/UIListMeeting_arrow.png',
    bgColor: '#F5F5F5',
    textColor: '#8E8E8E',
    textDown: '下拉可以刷新...',
    textUp: '松开开始刷新...',
    showTime: true
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

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)

上拉加载的事件回调

示例代码

var UIListMeeting = api.require('UIListMeeting');
UIListMeeting.setRefreshFooter({
    id:1,
    loadingImg: 'widget://res/UIListMeeting_arrow.png',
    bgColor: '#F5F5F5',
    textColor: '#8E8E8E',
    textUp: '上拉加载更多...',
    textDown: '松开开始加载...',
    showTime: true
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

是否仍需要帮助? 请保持联络!
最后更新于 2024/07/22