UICoverFlowS
概述
UICoverFlowS 实现可以带倒影的轮折叠的轮播图效果。
open
打开 UICoverFlowS
open({params}, callback(ret, err))
rect:
- 类型:JSON 类型
- 描述:(可选项)模块的位置及尺寸
- 内部字段:
styles:
- 类型:JSON 类型
- 描述:图片流的整体样式设置
- 内部字段:
bg: '#fff', //(可选项)字符串类型;图片流的背景,支持 rgb,rgba,#,img;默认:#fff
image:{
activeW: 300, //(可选项)数字类型;当前图片的显示宽度;默认:w*2.0/3.0
activeH: 400, //(可选项)数字类型;当前图片的显示高度;默认:h
corner: 2, //(可选项)数字类型;图片圆角半径;默认:2
placeholder: 'widget://placeholder.png', //(可选项)字符串类型;占位图片的路径,要求本地路径(fs://、widget://),若不传则不显示占位图
}
}
index:
- 描述:(可选项)初始选中的图片索引值,从 0 开始
- 默认:0
reflect:
- 类型:布尔类型
- 描述:(可选项)图片是否显示倒影
- 默认:false
isOpenAutoScroll:
- 类型:布尔类型
- 描述:(可选项)轮播图是否开启无限自动轮播
- 默认:false
autoTime:
- 类型:数字类型
- 描述:(可选项)自动轮播间隔时间(秒)
- 默认:2
images:
- 类型:JSON 数组
- 描述:为图片流指定数据
- 内部字段:
[{
url: 'widget://res/coverflow/0.png' //字符串类型;对应图片的网址,支持 fs://、widget://、http://等
}]
- 类型:字符串类型
- 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
- 默认:模块依附于当前 window
fixed:
- 类型:布尔
- 描述:(可选项)是否将模块视图固定到窗口上,不跟随窗口上下滚动
- 默认值:true(不随之滚动)
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
示例代码
var UICoverFlowS = api.require('UICoverFlowS');
UICoverFlowS.open({
rect: {
x: 0,
y: 60,
w: api.winWidth,
h: 480
styles: {
bg: '#fff',
image: {
activeW: 300,
activeH: 400,
corner: 2,
placeholder: 'widget://placeholder.png'
},
images: [{
url: 'widget://res/coverflow/0.png'
}, {
url: 'widget://res/coverflow/1.png'
}, {
url: 'widget://res/coverflow/2.png'
}, {
url: 'widget://res/coverflow/3.png'
}],
interval: 2000,
fixedOn: api.frameName,
fixed: false
}, function(ret, err) {
if (ret) {
alert(JSON.stringify(ret));
} else {
alert(JSON.stringify(err));
}
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
setIndex
滚动到指定条目
setIndex({params})
params
index:
- 类型:数字
- 描述:滚动的指定位置索引
id:
- 类型:数字
- 描述:轮播图对应id
var UICoverFlowS = api.require('UICoverFlowS');
UICoverFlowS.setIndex({
id:1,
index: 1
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
close
关闭 UICoverFlowS
close()
params
- 类型:数字
- 描述:轮播图对应id
示例代码
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
hide
隐藏显示的 coverFlow
hide()
id:
- 类型:数字
- 描述:轮播图对应id
示例代码
var UICoverFlowS = api.require('UICoverFlowS');
UICoverFlowS.hide({id:1});
补充说明
只是隐藏模块视图,并没有从内存里清除
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
show
显示已隐藏的 UICoverFlowS
show()
params
id:
- 类型:数字
- 描述:轮播图对应id
可用性
iOS系统,Android系统