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及更高版本