scrollRotation

open

setIndex

show

hide

close

概述

scrollRotation 是一个图片旋转联播器，实现了类似扑克牌效果的图片转动联播。开发者可自定义图片的数量，点击中间图片时会有回调，让开发者自定义点击跳转连接

图片说明

open

打开滚动旋转器

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

params

x：

  • 类型：数字
  • 描述：（可选项）插件左上角的 x 坐标（相对于所属的 Window 或 Frame）
  • 默认值：0

y：

  • 类型：数字
  • 描述：（可选项）插件左上角的 y 坐标（相对于所属的 Window 或 Frame）
  • 默认值：0

w：

  • 类型：数字
  • 描述：（可选项）插件的宽度
  • 默认值：当前设备屏幕的宽

h：

  • 类型：数字
  • 默认值：w-20
  • 描述：（可选项）插件的高度

items：

  • 类型：数组
  • 描述：每项的信息成的数组
  • 内部字段：
[{
    imgPath : 		//字符串类型；图片路径，要求本地协议（widget://、fs://）
    title:          //字符串类型；说明文字
    fontColor:      //字符串类型；字体颜色，支持 rgba、rgb、#；默认：#fff
    fontSize:       //数字类型；字体大小；默认：13
}]

cornerRadius：

  • 类型：数字
  • 描述：（可选项）每条目图片的圆角大小（圆角的半径）
  • 默认值：0

intervalTime：

  • 类型：数字
  • 描述：（可选项）自动连播时间间隔，若不传则不自动连播

pageControl：

  • 类型：JSON 对象
  • 描述：（可选项）页面控制器参数，若不传则不显示页面控制器
  • 内部字段：
{
    normalColor： 		//字符串类型，可为空，常色值，默认#FFFFFF
    selectedColor：     //字符串类型，可为空，选中值，默认#DA70D6
    heightPercent：     //数字类型，可为空，Y轴高度百分比，默认50.0
}

fixedOn：

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

fixed:

  • 类型：布尔
  • 描述：（可选项）插件是否随所属 window 或 frame 滚动
  • 默认值：true（不随之滚动）

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
    click:          //布尔值类型；是否是点击事件
    index:          //数字类型；滚动后中间图片及其点击事件的索引
}

示例代码

var scrollRotation = api.require('scrollRotation');
scrollRotation.open({
    x: 30,
    y: api.frameHeight / 2 - 170,
    w: api.frameWidth - 60,
    h: 340,
    items: [{
        imgPath: 'widget://res/img/apicloud.png',
        title: 'apicloud',
        fontColor: '#ffffff',
        fontSize: 16
    }, {
        imgPath: 'widget://res/img/apicloud-gray.png',
        title: 'apicloud',
        fontColor: '#ffffff',
        fontSize: 16
    }, {
        imgPath: 'widget://res/img/apicloud.png',
        title: 'apicloud',
        fontColor: '#ffffff',
        fontSize: 16
    }, {
        imgPath: 'widget://res/img/apicloud-gray.png',
        title: 'apicloud',
        fontColor: '#ffffff',
        fontSize: 16
    }],
    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及更高版本

setIndex

滚动到指定条目

setIndex({params})

params

index：

  • 类型：数字
  • 描述：滚动的指定位置索引
  • 默认值：0

animation：

  • 类型：布尔
  • 描述：滚动时是否带动画效果（0.3s的滚动动画效果）
  • 默认值：true

示例代码

var scrollRotation = api.require('scrollRotation');
scrollRotation.setIndex({
    index: 1,
    animation: false
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

show

显示视图

show()

示例代码

var scrollRotation = api.require('scrollRotation');
scrollRotation.show();

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

hide

隐藏视图

hide()

示例代码

var scrollRotation = api.require('scrollRotation');
scrollRotation.hide();

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

close

关闭视图

close()

示例代码

var scrollRotation = api.require('scrollRotation');
scrollRotation.close();

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2024/11/18