floatButton

来自于：开发者立即使用

setOnClickListener openButton hidenButton showButton closeButton updateButtonPic startAnimation stopAnimation startMove stopMove stopMove

论坛示例

为帮助用户更好更快的使用模块，论坛维护了一个示例，示例中包含示例代码供您参考。

概述

floatButton 用原生代码实现了在app内部实现悬浮按钮功能。

固件要求

Android：2.3.1及以上 iOS：7.0及以上

setOnClickListener

悬浮按钮点击事件监听

setOnClickListener(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true      //布尔型；true
  3. }

示例代码

  1. var demo = api.require('floatButton');
  2. demo.setOnClickListener(function(ret) {
  3.     alert(JSON.stringify(ret));
  4. });

可用性

Android、iOS系统

可提供的1.0.0及更高版本

openButton

打开悬浮按钮

openButton({params}, callback(ret))

params

rect：

  • 类型：JSON 对象
  • 描述：（必填项）模块的位置及尺寸
  • 内部字段：
  1. {
  2.     x : 0, //（必填项）数字类型；模块左上角的 x 坐标（相对于所属的 Window 或 Frame）；默认值：0
  3.     y : 0,   //（必填项）数字类型；模块左上角的 y 坐标（相对于所属的 Window 或 Frame）；默认值：0
  4.     w : 50, //（必填项）数字类型；悬浮按钮的高度；默认值：50
  5.     h : 50  //（必填项）数字类型；悬浮按钮的高度；默认值：50
  6. }

lineColor：

  • 类型：字符串
  • 描述：悬浮按钮边框颜色(如：#ff00ff)
  • 默认值：透明

btnPic：

  • 类型：字符串
  • 描述：（可选项）悬浮按钮图标。支持fs:// widget://(支持png,jpg,gif,[备注：安卓设置gif动图时lineColor会失效])

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true,      //布尔型；true
  3. }

示例代码

  1. var demo = api.require('floatButton');
  2. demo.openButton({
  3.     rect : {
  4.         x : 10,
  5.         y : 10,
  6.         w : 30,
  7.         h : 30
  8.     },
  9.     lineColor : '#000000',
  10.     btnPic : 'widget://image/refresh.png'
  11. }, function(ret) {
  12.     alert(JSON.stringify(ret));
  13. });

可用性

Android、iOS系统

可提供的1.0.0及更高版本

hidenButton

隐藏悬浮按钮

hidenButton(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true      //布尔型；true||false
  3. }

示例代码

  1. var demo = api.require('floatButton');
  2. demo.hidenButton(function(ret) {
  3.     alert(JSON.stringify(ret));
  4. });

可用性

Android、iOS系统

可提供的1.0.0及更高版本

showButton

显示悬浮按钮

showButton(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true      //布尔型；true||false
  3. }

示例代码

  1. var demo = api.require('floatButton');
  2. demo.showButton(function(ret) {
  3.     alert(JSON.stringify(ret));
  4. });

可用性

Android、iOS系统

可提供的1.0.0及更高版本

closeButton

关闭悬浮按钮

closeButton(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true      //布尔型；true||false
  3. }

示例代码

  1. var demo = api.require('floatButton');
  2. demo.closeButton(function(ret, err) {
  3.     alert(JSON.stringify(ret));
  4. });

可用性

Android、iOS系统

可提供的1.0.0及更高版本

updateButtonPic

修改悬浮按钮图片

updateButtonPic({params}, callback(ret))

params

btnPic：

  • 类型：字符串
  • 描述：（可选项）悬浮按钮图标。支持fs:// widget://(支持png,jpg,gif,[备注：安卓设置gif动图时lineColor会失效])

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true,      //布尔型；true||false
  3. }

示例代码

  1. var demo = api.require('floatButton');
  2. demo.updateButtonPic({
  3.     btnPic : 'widget://image/refresh.png'
  4. }, function(ret) {
  5.     alert(JSON.stringify(ret));
  6. });

可用性

Android、iOS系统

可提供的1.0.0及更高版本

startAnimation

开启旋转动画

startAnimation(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true      //布尔型；true||false
  3. }

示例代码

  1. var demo = api.require('floatButton');
  2. demo.startAnimation(function(ret) {
  3.     alert(JSON.stringify(ret));
  4. });

可用性

Android、iOS系统

可提供的1.0.0及更高版本

stopAnimation

停止旋转动画

stopAnimation(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true      //布尔型；true||false
  3. }

示例代码

  1. var demo = api.require('floatButton');
  2. demo.stopAnimation(function(ret) {
  3.     alert(JSON.stringify(ret));
  4. });

可用性

Android、iOS系统

可提供的1.0.0及更高版本

startMove

开启移动

startMove(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true      //布尔型；true||false
  3. }

示例代码

  1. var demo = api.require('floatButton');
  2. demo.startMove(function(ret) {
  3.     alert(JSON.stringify(ret));
  4. });

可用性

Android、iOS系统

可提供的1.0.0及更高版本

stopMove

停止移动

stopMove(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true      //布尔型；true||false
  3. }

示例代码

  1. var demo = api.require('floatButton');
  2. demo.stopMove(function(ret) {
  3.     alert(JSON.stringify(ret));
  4. });

可用性

Android、iOS系统

可提供的1.0.0及更高版本

setOnCoordinateListener

坐标移动监听

setOnCoordinateListener(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     x: 0,
  3.     y: 0
  4. }

示例代码

  1. var demo = api.require('floatButton');
  2. demo.setOnCoordinateListener(function(ret) {
  3.     alert(JSON.stringify(ret));
  4. });

可用性

Android、iOS系统

可提供的1.0.0及更高版本