openWidget

打开 Widget，若此 widget 已经被打开，则会把其调整到最前面显示

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

params

id：

  • 类型：字符串
  • 默认值：无
  • 描述：（可选项）widget的id

path：

  • 类型：字符串
  • 默认值：无
  • 描述：（可选项）widget的根目录，该目录下面放置有config.xml等文件。通过传入此字段，可以打开放置在任意位置的widget。注意若传了id字段，此字段将被忽略

wgtParam：

  • 类型：JSON 对象
  • 默认值：无
  • 描述：（可选项）widget 参数，在新打开的 widget 里面的页面中通过 api.wgtParam 获取

longPressToExit：

  • 类型：布尔
  • 默认值：true
  • 描述：（可选项）在新打开的 widget 里面的页面中是否支持长按退出，只支持iOS。

animation：

  • 类型：JSON 对象
  • 默认值：无
  • 描述：（可选项）动画参数，不传时使用默认动画
  • 内部字段：
  1. {
  2.     type:"none",                 //动画类型（详见动画类型常量）
  3.     subType:"from_right",        //动画子类型（详见动画子类型常量）
  4.     duration:300                 //动画过渡时间，默认300毫秒
  5. }
  7. type 取值范围：
  9. none            //无动画效果
  10. push            //新视图将旧视图推开
  11. movein          //新视图移到旧视图上面
  12. fade            //交叉淡化过渡（不支持过渡方向）
  13. flip            //翻转效果
  14. reveal          //将旧视图移开,显示下面的新视图
  15. ripple          //滴水效果（不支持过渡方向）
  16. curl            //向上翻一页
  17. un_curl         //向下翻一页
  18. suck            //收缩效果（不支持过渡方向）
  19. cube            //立方体翻滚效果
  21. subType 取值范围：
  23. from_right      //从右边开始动画
  24. from_left       //从左边开始动画
  25. from_top        //从顶部开始动画
  26. from_bottom     //从底部开始动画
  28. （Android系统flip，ripple，curl，un_curl，suck，cube 类型不支持）

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 描述：新 widget 关闭时候的返回值

示例代码

  1. api.openWidget({
  2.     id: 'A00000001',
  3.     animation: {
  4.         type: 'flip',
  5.         subType: 'from_bottom',
  6.         duration: 500
  7.     }
  8. }, function(ret, err) {
  9.     if (ret) {
  10.         alert(JSON.stringify(ret));
  11.     } else {
  12.         alert(JSON.stringify(err));
  13.     }
  14. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本