fluttering
来自于:开发者立即使用
概述
图片飘屏动画模块,模块封装了例如点赞时心形图案按照一定的轨迹飘动的场景。开发者可自定义飘动的图片,图标大小,及其飘动的动画持续时长。
开发者在使用本模块时,需要首先调用 config 接口,配置飘屏动画的起点、终点、时长,飘动的路径由模块随机产生。然后再调用 flutter 接口传入图片大小和地址,模块即可完成一次图片飘动效果,反复多次调用 flutter 接口并且传入不同的图片地址和大小,即可实现连续飘动的炫酷动画效果。
注意:
飘动的图标依附于当前 Window 或 Frame,参考 config 接口内 fixedOn 参数。本模块不能将模块视图固定到窗口上跟随窗口上下滚动(不支持自定义 fixed 参数)
模块接口
config
配置飘动动画
config({params}, callback(ret, err))
params
original:
- 类型:JSON 对象
- 描述:图标飘动动画的起点位置坐标
- 内部字段:
{
x: 0, //(可选项)数字类型;飘动动画的起点 x 坐标(相对于所属的 Window 或 Frame);默认:所属Window 或 Frame居中位置
y: 0, //(可选项)数字类型;飘动动画的起点 y 坐标(相对于所属的 Window 或 Frame);默认:所属Window 或 Frame最下端(总高度-44.0)
}
terminal:
- 类型:JSON 对象
- 描述:图标飘动动画的终点位置坐标
- 内部字段:
{
x: 0, //(可选项)数字类型;飘动动画的终点 x 坐标(相对于所属的 Window 或 Frame);默认:0
y: 0, //(可选项)数字类型;飘动动画的终点 y 坐标(相对于所属的 Window 或 Frame);默认:0
}
duration:
- 类型:数字
- 描述:(可选项)飘屏动画的持续时间,单位:秒(s)
- 默认:4
fixedOn:
- 类型:字符串
- 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
- 默认:模块依附于当前 window
callback(ret)
ret:
- 类型:JSON 对象
- 内部字段:
{
status: true //布尔类型;是否配置成功,true|false
}
示例代码
var fluttering = api.require('fluttering');
fluttering.config({
original: {
x:0,
y:64,
},
terminal: {
x:0,
y:64,
},
duration: 4
}, function(ret) {
alert(JSON.stringify(ret));
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
flutter
开始飘动(飘动的动画路径随机产生)
flutter({params})
params
size:
- 类型:数字
- 描述:(可选项)本次飘动的图标的大小
- 默认:40
path:
- 类型:字符串
- 描述:(可选项)本次飘动图片的路径,支持本地路径(fs://、widget://)
示例代码
var fluttering = api.require('fluttering');
fluttering.flutter({
size:40,
path: 'widget://res/a.png'
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本