ruler

openRuler

hideRuler

showRuler

closeRuler

论坛示例

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

概述

ruler 插件概述

本插件封装了iOS和Android下尺子UI的功能，方便实现一些拖动刻度的功能(备注：iOS和Android的UI效果有差异)。

固件要求

Android：4.1及以上 iOS：8.0及以上

插件接口

openRuler

打开尺子

openRuler({params}, callback(ret))

params

rect：

  • 类型：JSON 对象
  • 描述：（必填项）插件的位置及尺寸
  • 备注：iOS,Android 必须传此参数。
  • 内部字段：
{
    x: 0,   //（必填项）数字类型；插件左上角的 x 坐标（相对于所属的 Window 或 Frame）；默认值：0
    y: 0,   //（必填项）数字类型；插件左上角的 y 坐标（相对于所属的 Window 或 Frame）；默认值：0
    w: 320, //（必填项）数字类型；插件的宽度；默认值：所属的 Window 或 Frame 的宽度
    h: 150  //（可选项）数字类型；插件的高度；默认值：150(该值不能太小，否则刻度不能正常显示,请开发者自行控制)
}

fixedOn：

  • 类型：字符串
  • 描述：（可选项）插件所属 Frame 的名字，若不传则插件归属于当前 Window

fixed：

  • 类型：布尔
  • 描述：（可选项）插件是否随所属 Window 或 Frame 滚动
  • 默认值：true（不随之滚动）

rulerCount：

  • 类型：数字型
  • 描述：（可选项）尺子的总刻度
  • 默认值：20

currentValue：

  • 类型：数字型
  • 描述：（可选项）尺子的当前刻度值
  • 默认值：16

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
    status: true,      //布尔型；true
    rulerValue : 15,  //滑动选中的刻度值
    index : 0,        //当前打开刻度尺视图序号
}

示例代码

var demo = api.require('ruler');
demo.openRuler({
    rect : {
        x : 0,
        y : 300,
        w : 300,
    },
    rulerCount : 200,
    currentValue : 150,
    fixedOn : api.frameName,
    fixed : true
},function(ret, err){	                   api.toast({ msg:JSON.stringify(ret) });
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

hideRuler

隐藏尺子

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

params

index：

  • 类型：数字型
  • 描述：（可选项）刻度尺视图序号
  • 默认值：0

callback(ret, err)

ret：

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

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: ""
}

示例代码

var demo = api.require('ruler');
demo.hideRuler(function(ret,err){api.toast({ msg:JSON.stringify(ret) });});

可用性

Android、iOS系统

可提供的1.0.0及更高版本

showRuler

显示尺子

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

params

index：

  • 类型：数字型
  • 描述：（可选项）刻度尺视图序号
  • 默认值：0

callback(ret, err)

ret：

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

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: ""
}

示例代码

var demo = api.require('ruler');
demo.showRuler(function(ret,err){api.toast({ msg:JSON.stringify(ret) });});

可用性

Android、iOS系统

可提供的1.0.0及更高版本

closeRuler

关闭尺子

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

params

index：

  • 类型：数字型
  • 描述：（可选项）刻度尺视图序号
  • 默认值：0

callback(ret, err)

ret：

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

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: ""
}

示例代码

var demo = api.require('ruler');
demo.closeRuler(function(ret,err){api.toast({ msg:JSON.stringify(ret) });});

可用性

Android、iOS系统

可提供的1.0.0及更高版本

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