fluttering

来自于:开发者立即使用

config flutter

概述

图片飘屏动画模块,模块封装了例如点赞时心形图案按照一定的轨迹飘动的场景。开发者可自定义飘动的图片,图标大小,及其飘动的动画持续时长。

开发者在使用本模块时,需要首先调用 config 接口,配置飘屏动画的起点、终点、时长,飘动的路径由模块随机产生。然后再调用 flutter 接口传入图片大小和地址,模块即可完成一次图片飘动效果,反复多次调用 flutter 接口并且传入不同的图片地址和大小,即可实现连续飘动的炫酷动画效果。

注意:

飘动的图标依附于当前 Window 或 Frame,参考 config 接口内 fixedOn 参数。本模块不能将模块视图固定到窗口上跟随窗口上下滚动(不支持自定义 fixed 参数)

图片说明

模块接口

config

配置飘动动画

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

params

original:

  • 类型:JSON 对象
  • 描述:图标飘动动画的起点位置坐标
  • 内部字段:
  1. {
  2. x: 0, //(可选项)数字类型;飘动动画的起点 x 坐标(相对于所属的 Window 或 Frame);默认:所属Window 或 Frame居中位置
  3. y: 0, //(可选项)数字类型;飘动动画的起点 y 坐标(相对于所属的 Window 或 Frame);默认:所属Window 或 Frame最下端(总高度-44.0)
  4. }

terminal:

  • 类型:JSON 对象
  • 描述:图标飘动动画的终点位置坐标
  • 内部字段:
  1. {
  2. x: 0, //(可选项)数字类型;飘动动画的终点 x 坐标(相对于所属的 Window 或 Frame);默认:0
  3. y: 0, //(可选项)数字类型;飘动动画的终点 y 坐标(相对于所属的 Window 或 Frame);默认:0
  4. }

duration:

  • 类型:数字
  • 描述:(可选项)飘屏动画的持续时间,单位:秒(s)
  • 默认:4

fixedOn:

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

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true //布尔类型;是否配置成功,true|false
  3. }

示例代码

  1. var fluttering = api.require('fluttering');
  2. fluttering.config({
  3. original: {
  4. x:0,
  5. y:64,
  6. },
  7. terminal: {
  8. x:0,
  9. y:64,
  10. },
  11. duration: 4
  12. }, function(ret) {
  13. alert(JSON.stringify(ret));
  14. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

flutter

开始飘动(飘动的动画路径随机产生)

flutter({params})

params

size:

  • 类型:数字
  • 描述:(可选项)本次飘动的图标的大小
  • 默认:40

path:

  • 类型:字符串
  • 描述:(可选项)本次飘动图片的路径,支持本地路径(fs://、widget://)

示例代码

  1. var fluttering = api.require('fluttering');
  2. fluttering.flutter({
  3. size:40,
  4. path: 'widget://res/a.png'
  5. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本