shakeView

Method
Constant

open

shake

hide

show

概述

shakeView 封装了一个可供开发者自定义的摇一摇界面，包括动画方向，震动，声音等摇一摇时特定的效果，都可自定义。使用此插件有效的解决了前端实现摇一摇动画不流畅问题

alert

open

打开摇一摇视图

open({params})

params

x：

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

y：

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

w：

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

h：

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

type：

类型：字符串
描述：（可选项）摇一摇视图类型，取值范围见摇一摇类型常量
默认值：up_down

anim：

类型：JSON 对象
描述：（可选项）视图动画的参数配置
内部字段：

{
    time:          //（可选项）数字类型；动画持续时间；默认：3.0秒
    sound:         //（可选项）字符串类型；摇动后的音效文件路径，要求本地路径（fs://、widget://），若不传则无声音提示
    isShake:       //（可选项）布尔类型；是否添加手机震动效果；默认：false   
    percent:       //（可选项）数字类型；裂开距离占摇动视图的百分比；默认：50
}

img：

类型：JSON 对象
描述：视图界面图片配置
内部字段：

{
    leftUp:           //字符串类型；左边（上面）的图片路径，要求本地路径（widget://、fs://）；默认：灰色视图
    rightDown:        //字符串类型；右边（下面）的图片路径，要求本地路径（widget://、fs://）；默认：灰色视图
    bg:               //（可选项）字符串类型；背景图片路径，要求本地路径（widget://、fs://）；默认：绿色视图
    shake：           //（可选项）字符串类型；震动效果动画时震动（抖动）的图片路径，要求本地路径（widget://、fs://），当type为up_down或left_right时忽略此参数
}

fixedOn：

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

fixed:

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

示例代码

var shakeView = api.require('shakeView');
shakeView.open({
    x: 0,
    y: 300,
    w: api.winWidth,
    h: 300,
    type: 'left_right',
    img: {
        leftUp: 'widget://res/1.png',
        rightDown: 'widget://res/2.png',
        bg: 'widget://res/3.png'

    },
    anim: {
        time: '2',
        sound: '',
        isShake: true,
        percent: 50
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

shake

触发摇一摇事件

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

params

anim：

类型：JSON 对象
描述：（可选项）视图动画的参数配置
内部字段：

{
    time:          //（可选项）数字类型；动画持续时间；默认：3.0秒
    sound:         //（可选项）字符串类型；摇动后的音效文件路径，要求本地路径（fs://、widget://），若不传则无声音提示
    isShake:       //（可选项）布尔类型；是否添加手机震动效果；默认：false   
    percent:       //（可选项）数字类型；裂开距离占摇动视图的百分比；默认：50
}

callback(ret, err)

回调摇一摇动画结束事件

示例代码

var shakeView = api.require('shakeView');
shakeView.shake(function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

hide

隐藏视图

hide()

示例代码

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

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

show

显示视图

show()

示例代码

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

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

close

关闭视图

close()

示例代码

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

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

视图类型

摇一摇界面类型。字符串类型

##取值范围：

up_down //触动摇动动画后视图上下裂开
left_right //触动摇动动画后视图左右裂开
shake //触动摇动动画后视图左右晃动

是否仍需要帮助？请保持联络！

最后更新于 2024/07/31