pullMenu

来自于:官方立即使用

概述

pullMenu 是一个可上下拖动的菜单,可随手指上下滑动。其子菜单按钮都可自定义样式,超过部分可拖动查看。性能强,流畅度高

图片说明

open

打开拖拉菜单

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

params

type:

  • 类型:字符串
  • 默认值:up
  • 描述:(可选项)菜单类型,0代表从上往下弹出,1代表从下往上弹出,取值范围up--从上往下、down--从下往上

h:

  • 类型:数字
  • 默认值:当前设备屏幕高度的三分之二
  • 描述:(可选项)菜单视图的高

btnWidth:

  • 类型:数字
  • 默认值:60
  • 描述:(可选项)菜单里每个按钮的(正方形)边长

alpha:

  • 类型:数字
  • 默认值:0.8
  • 描述:(可选项)菜单背景透明度,取值范围为0-1

bgColor:

  • 类型:字符串
  • 默认值:#FFFFFF
  • 描述:(可选项)菜单背景色,支持 rgb,rgba,#

btnArray:

  • 类型:数组
  • 默认值:无
  • 描述:(可选项)菜单里每个按钮的背景图片、选中图片路径组成的数组
  • 内部字段:
[{
      normal:          //按钮常态下的图标,字符串,支持fs、widget等本地路径协议
      highlight:        //按钮选中后的图标,字符串,支持fs、widget等本地路径协议
}]

selectedIndex:

  • 类型:数字
  • 默认值:无
  • 描述:(可选项)设置默认选中按钮的索引

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    index:        //用户点击按钮的下标
}

示例代码

var pullMenu = api.require('pullMenu');
pullMenu.open({
    btnArray: [{
        normal: 'widget://res/img/ic/small-bell.png',
        highlight: 'widget://res/img/ic/small-bell.png'
    }, {
        normal: 'widget://res/img/ic/small-bell.png',
        highlight: 'widget://res/img/ic/small-bell.png'
    }]
}, function(ret, err) {
    if (ret) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

补充说明

打开菜单

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

hidden

隐藏菜单

hidden()

示例代码

var pullMenu = api.require('pullMenu');
pullMenu.hidden();

补充说明

隐藏菜单,只是移除到屏幕之外,还在内存里没有清除

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setSelected

设置按钮选中/取消状态

setSelected({params})

params

index:

  • 类型:数字
  • 默认值:0
  • 描述:(可选项)要设置的按钮的索引

    selected:

  • 类型:布尔

  • 默认值:true
  • 描述:(可选项)是否要将指定索引的按钮设置为选中状态

示例代码

var pullMenu = api.require('pullMenu');
pullMenu.setSelected({
    index: 2,
    selected: true
});

补充说明

可用性

iOS系统,Android系统

可提供的1.0.1及更高版本

hide

隐藏菜单

hide()

示例代码

var pullMenu = api.require('pullMenu');
pullMenu.hide();

补充说明

隐藏菜单,只是移除到屏幕之外,还在内存里没有清除

可用性

iOS系统,Android系统

可提供的1.0.1及更高版本

show

显示菜单

show()

示例代码

var pullMenu = api.require('pullMenu');
pullMenu.show();

补充说明

显示菜单,从屏幕外移动到屏幕内

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

close

关闭菜单

close()

示例代码

var pullMenu = api.require('pullMenu');
pullMenu.close();

补充说明

关闭菜单,意味着从内存里清除

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本