shakeView
概述
shakeView 封装了一个可供开发者自定义的摇一摇界面,包括动画方向,震动,声音等摇一摇时特定的效果,都可自定义。使用此模块有效的解决了前端实现摇一摇动画不流畅问题
open
打开摇一摇视图
open({params})
x:
- 描述:(可选项)模块左上角的 x 坐标(相对于所属的 Window 或 Frame)
- 默认值:0
y:
- 类型:数字
- 描述:(可选项)模块左上角的 y 坐标(相对于所属的 Window 或 Frame)
- 默认值:0
w:
- 类型:数字
- 描述:(可选项)模块的宽度
- 默认值:当前设备屏幕宽
h:
- 类型:数字
- 描述:(可选项)模块的高度
- 默认值:w
type:
- 类型:字符串
- 描述:(可选项)摇一摇视图类型,取值范围见
- 默认值:up_down
anim:
- 类型:JSON 对象
- 描述:(可选项)视图动画的参数配置
- 内部字段:
- 类型:JSON 对象
- 描述:视图界面图片配置
- 内部字段:
leftUp: //字符串类型;左边(上面)的图片路径,要求本地路径(widget://、fs://);默认:灰色视图
rightDown: //字符串类型;右边(下面)的图片路径,要求本地路径(widget://、fs://);默认:灰色视图
shake: //(可选项)字符串类型;震动效果动画时震动(抖动)的图片路径,要求本地路径(widget://、fs://),当type为up_down或left_right时忽略此参数
fixedOn:
- 类型:字符串类型
- 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
- 默认:模块依附于当前 window
fixed:
- 类型:布尔
- 描述:(可选项)模块是否随所属 window 或 frame 滚动
- 默认值:true(不随之滚动)
示例代码
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
shake
触发摇一摇事件
shake({params}, callback(ret, err))
params
anim:
- 类型:JSON 对象
- 描述:(可选项)视图动画的参数配置
- 内部字段:
{
time: //(可选项)数字类型;动画持续时间;默认:3.0秒
sound: //(可选项)字符串类型;摇动后的音效文件路径,要求本地路径(fs://、widget://),若不传则无声音提示
isShake: //(可选项)布尔类型;是否添加手机震动效果;默认:false
}
回调摇一摇动画结束事件
示例代码
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
hide
隐藏视图
示例代码
var shakeView = api.require('shakeView');
shakeView.hide();
iOS系统,Android系统
可提供的1.0.0及更高版本
show
显示视图
show()
示例代码
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
close
关闭视图
close()
示例代码
var shakeView = api.require('shakeView');
iOS系统,Android系统
可提供的1.0.0及更高版本
视图类型
摇一摇界面类型。字符串类型
取值范围:
- up_down //触动摇动动画后视图上下裂开
- left_right //触动摇动动画后视图左右裂开