scrollRotation

• Method

setIndex hide

概述

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

open

打开滚动旋转器

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

x：

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

y：

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

w：

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

h：

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

items：

• 类型：数组
• 内部字段：

cornerRadius：

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

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

pageControl：

• 类型：JSON 对象
• 描述：（可选项）页面控制器参数，若不传则不显示页面控制器
• 内部字段：

    normalColor：         //字符串类型，可为空，常色值，默认#FFFFFF
    selectedColor：     //字符串类型，可为空，选中值，默认#DA70D6
    heightPercent：     //数字类型，可为空，Y轴高度百分比，默认50.0
}

fixedOn：

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

fixed:

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

callback(ret, err)

ret：

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

示例代码

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',
        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',
        fontColor: '#ffffff',
        fontSize: 16
    }],
    fixedOn: api.frameName
}, function(ret, err) {
    if (ret) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setIndex

滚动到指定条目

setIndex({params})

index：

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

animation：

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

示例代码

可用性

iOS系统，Android系统

show

显示视图

show()

示例代码

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

iOS系统，Android系统

可提供的1.0.0及更高版本

hide

隐藏视图

hide()

示例代码

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

close

关闭视图

close()

示例代码

scrollRotation.close();

iOS系统，Android系统