shakeView

open hide close

概述

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

open

打开摇一摇视图

open({params})

x:

  • 描述:(可选项)模块左上角的 x 坐标(相对于所属的 Window 或 Frame)
  • 默认值:0

y:

  • 类型:数字
  • 描述:(可选项)模块左上角的 y 坐标(相对于所属的 Window 或 Frame)
  • 默认值:0

w:

  • 类型:数字
  • 描述:(可选项)模块的宽度
  • 默认值:当前设备屏幕宽

h:

  • 类型:数字
  • 描述:(可选项)模块的高度
  • 默认值:w

type:

  • 类型:字符串
  • 描述:(可选项)摇一摇视图类型,取值范围见
  • 默认值:up_down

anim:

  • 类型:JSON 对象
  • 描述:(可选项)视图动画的参数配置
  • 内部字段:
  • 类型:JSON 对象
  • 描述:视图界面图片配置
  • 内部字段:
  1. leftUp: //字符串类型;左边(上面)的图片路径,要求本地路径(widget://、fs://);默认:灰色视图
  2. rightDown: //字符串类型;右边(下面)的图片路径,要求本地路径(widget://、fs://);默认:灰色视图
  3. 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 对象
  • 描述:(可选项)视图动画的参数配置
  • 内部字段:
  1. {
  2. time: //(可选项)数字类型;动画持续时间;默认:3.0秒
  3. sound: //(可选项)字符串类型;摇动后的音效文件路径,要求本地路径(fs://、widget://),若不传则无声音提示
  4. isShake: //(可选项)布尔类型;是否添加手机震动效果;默认:false
  5. }

回调摇一摇动画结束事件

示例代码

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

hide

隐藏视图

示例代码

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

iOS系统,Android系统

可提供的1.0.0及更高版本

show

显示视图

show()

示例代码

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

close

关闭视图

close()

示例代码

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

iOS系统,Android系统

可提供的1.0.0及更高版本

视图类型

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

取值范围:

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