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) {
   api.alert({msg: 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及更高版本

是否仍需要帮助? 请保持联络!
最后更新于 2024/04/24