popupMenu

open

概述

popupMenu 提供了一个气泡菜单的功能，开发者可以设置气泡菜单的位置，和菜单按钮的背景颜色、字体大小等功能

open

弹出气泡菜单

open({params}, callback(ret))

rect：

  • 类型：JSON 对象
  • 描述：气泡菜单的位置和大小
  • 内部字段：
  • 类型：字符串
  • 默认值：’#000000’
  • 描述：（可选项）气泡菜单的背景颜色，支持 rgb，rgba，#，

corner：

  • 类型：数字类型
  • 默认值：5
  • 描述：（可选项）（仅iOS支持）气泡菜单的圆角大小

triangleStyle：

  • 类型：JSON 对象
  • 描述：三角图标的指向和位置
  • 内部字段：
  2.     triangleRect:{（仅iOS有效）
  3.        x:0,    //相对于气泡菜单的x坐标
  4.        y:20,   //相对于气泡菜单的y坐标
  5.        w:5,    //三角图标的宽度
  6.        h:10    //三角图标的高度
  7.     },
  8.     direction:'right',   //字符串类型；三角图标的方向；right：朝右指向，left：朝左指向，up：朝上指向，down：朝下指向
  9. }

verticalOrHorizontal：

  • 类型：字符串类型
  • 默认值：’horizontal’
  • 描述：（可选项）按钮列表展示方向
    • ‘horizontal’ //水平展示
    • ‘vertical’ //竖直展示

line：

  • 类型：JSON 对象
  • 描述：气泡菜单按钮分割线
  • 内部字段：

btnArr：

  • 类型：数组类型
  • 描述：弹出的气泡菜单的信息，该数组有多少个元素，则有多少个菜单按钮
  • 内部字段：
  1. [{    
  2.    btnWidth:60,   // （可选项）（仅iOS支持）数字类型；按钮宽度；默认：60
  3.    btnHeight:40,  // （可选项）（仅iOS支持）数字类型；按钮高度；默认：40
  4.    btnTitle:'标题1', // （可选项）字符串类型；按钮标题；默认：空
  5.    textColor:'#DAA520', //（可选项）字符串类型；按钮标题颜色；支持 rgb，rgba，#，默认#FFFFFF
  6.    textHightColor:'#008B45', //（可选项）（仅iOS支持）字符串类型；按钮高亮状态下标题颜色；支持 rgb，rgba，#，默认#548B54
  7.    textHightBg:'',          //(可选项)（仅android支持）字符串类型，按钮按下时背景色；默认：‘#eeeeee’
  8.    textFont:15,    //（可选项）字符串类型；按钮标题大小；默认：15
  9.    textLocation:'left',  //(可选项)字符串类型；按钮标题的位置；'left'：居左，'center'：居中，'right'：居右；默认值：'left'
  10.    textMargin:5,  //（可选项）字符串类型；标题的边距；默认值：5
  11.    isImg:true, //(可选项)布尔类型；是否有图标；默认：NO
  12.    imgLocation:'left',  //（可选项）字符串类型；图标的位置；'left'：居左，'right':居右,'top':居上，‘bottom’：居下；默认值：'left';注意（isImg为true时有效）
  13.    iconImg:'widget://res/img', //字符串类型；图片的路径；注意（isImg为true时有效）
  14.    imgRect:{
  15.        x:10,  //图标相对于按钮的x坐标
  16.        y:5,   //图标相对于按钮的y坐标
  17.        w:30,  //图标的宽度
  18.        h:30,  //图标的高度
  19.    }
  20. }]

callback(ret)

  • 类型：JSON 对象
  • 内部字段：
  1. var name = api.require('popupMenu');
  2. name.open({
  3.       rect:{
  4.           x:300,
  5.           y:300,
  7.           h:40
  8.       },
  9.       bg:'#708090',
  10.       corner:5,
  11.       triangleStyle:{
  12.           triangleRect:{
  13.               x:0,    //相对于rect的x坐标
  14.               y:20,   //相对于rect的y坐标
  15.               w:5,
  16.               h:10
  17.           },
  18.           direction:'right',
  19.       },
  21.       verticalOrHorizontal:'vertical',
  22.       line:{
  23.           lineColor:'#7FFF00',
  24.           lineWidth:1
  25.       },
  27.       btnArr:[
  28.           {
  29.               btnWidth:60,
  30.               btnTitle:'标题1',
  31.               bgColor:'#8470FF',
  32.               textColor:'#DAA520',
  33.               textHightColor:'#008B45',
  34.               textFont:15,
  35.               textLocation:'right',
  36.               textMargin:5,
  37.               isImg:true,
  38.               imgLocation:'left',
  39.               iconImg:'widget://res/car14',
  41.                   x:10,
  42.                   y:5,
  43.                   w:30,
  44.                   h:30,
  45.               }
  46.           },
  47.           {
  48.               btnWidth:60,
  49.               btnHeight:40,
  50.               btnTitle:'标题2',
  51.               bgColor:'#8470FF',
  52.               textColor:'#DAA520',
  53.               textHightColor:'#008B45',
  54.               textFont:15,
  55.           },
  56.           {
  57.               btnWidth:60,
  58.               btnHeight:40,
  59.               btnTitle:'标题3',
  60.               bgColor:'#8470FF',
  61.               textColor:'#DAA520',
  62.               textHightColor:'#008B45',
  63.               textFont:15,
  64.           }
  65.       ]
  66. }, function(ret) {
  67.     if (ret) {
  68.        alert(JSON.stringify(ret));
  69.     }
  70. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

close

关闭气泡菜单

open(callback(ret))

ret：

  • 类型：JSON 对象
  • 内部字段：

示例代码

  1. var name = api.require('popupMenu');
  2. name.close(function(ret) {
  3.     if (ret) {
  4.        alert(JSON.stringify(ret));
  5. });

可提供的1.0.0及更高版本