UICoverFlowS

setIndex hide

概述

UICoverFlowS 实现可以带倒影的轮折叠的轮播图效果。

open

打开 UICoverFlowS

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

rect:

  • 类型:JSON 类型
  • 描述:(可选项)模块的位置及尺寸
  • 内部字段:

styles:

  • 类型:JSON 类型
  • 描述:图片流的整体样式设置
  • 内部字段:
  1. bg: '#fff', //(可选项)字符串类型;图片流的背景,支持 rgb,rgba,#,img;默认:#fff
  2. image:{
  3. activeW: 300, //(可选项)数字类型;当前图片的显示宽度;默认:w*2.0/3.0
  4. activeH: 400, //(可选项)数字类型;当前图片的显示高度;默认:h
  5. corner: 2, //(可选项)数字类型;图片圆角半径;默认:2
  6. placeholder: 'widget://placeholder.png', //(可选项)字符串类型;占位图片的路径,要求本地路径(fs://、widget://),若不传则不显示占位图
  7. }
  8. }

index:

  • 描述:(可选项)初始选中的图片索引值,从 0 开始
  • 默认:0

reflect:

  • 类型:布尔类型
  • 描述:(可选项)图片是否显示倒影
  • 默认:false

isOpenAutoScroll:

  • 类型:布尔类型
  • 描述:(可选项)轮播图是否开启无限自动轮播
  • 默认:false

autoTime:

  • 类型:数字类型
  • 描述:(可选项)自动轮播间隔时间(秒)
  • 默认:2

images:

  • 类型:JSON 数组
  • 描述:为图片流指定数据
  • 内部字段:
  1. [{
  2. url: 'widget://res/coverflow/0.png' //字符串类型;对应图片的网址,支持 fs://、widget://、http://等
  3. }]
  • 类型:字符串类型
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
  • 默认:模块依附于当前 window

fixed:

  • 类型:布尔
  • 描述:(可选项)是否将模块视图固定到窗口上,不跟随窗口上下滚动
  • 默认值:true(不随之滚动)

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:

示例代码

  1. var UICoverFlowS = api.require('UICoverFlowS');
  2. UICoverFlowS.open({
  3. rect: {
  4. x: 0,
  5. y: 60,
  6. w: api.winWidth,
  7. h: 480
  8. styles: {
  9. bg: '#fff',
  10. image: {
  11. activeW: 300,
  12. activeH: 400,
  13. corner: 2,
  14. placeholder: 'widget://placeholder.png'
  15. },
  16. images: [{
  17. url: 'widget://res/coverflow/0.png'
  18. }, {
  19. url: 'widget://res/coverflow/1.png'
  20. }, {
  21. url: 'widget://res/coverflow/2.png'
  22. }, {
  23. url: 'widget://res/coverflow/3.png'
  24. }],
  25. interval: 2000,
  26. fixedOn: api.frameName,
  27. fixed: false
  28. }, function(ret, err) {
  29. if (ret) {
  30. alert(JSON.stringify(ret));
  31. } else {
  32. alert(JSON.stringify(err));
  33. }
  34. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setIndex

滚动到指定条目

setIndex({params})

params

index:

  • 类型:数字
  • 描述:滚动的指定位置索引

id:

  • 类型:数字
  • 描述:轮播图对应id
  1. var UICoverFlowS = api.require('UICoverFlowS');
  2. UICoverFlowS.setIndex({
  3. id:1,
  4. index: 1
  5. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

close

关闭 UICoverFlowS

close()

params

  • 类型:数字
  • 描述:轮播图对应id

示例代码

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

hide

隐藏显示的 coverFlow

hide()

id:

  • 类型:数字
  • 描述:轮播图对应id

示例代码

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

补充说明

只是隐藏模块视图,并没有从内存里清除

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

show

显示已隐藏的 UICoverFlowS

show()

params

id:

  • 类型:数字
  • 描述:轮播图对应id

可用性

iOS系统,Android系统