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 对象
• 默认值：无
• 描述：（可选项）动画参数，不传时使用默认动画
• 内部字段：

{
    type:"none",                 //动画类型（详见动画类型常量）
    subType:"from_right",        //动画子类型（详见动画子类型常量）
    duration:300                 //动画过渡时间，默认300毫秒
}


type 取值范围：


none            //无动画效果
push            //新视图将旧视图推开
movein          //新视图移到旧视图上面
fade            //交叉淡化过渡（不支持过渡方向）
flip            //翻转效果
reveal          //将旧视图移开,显示下面的新视图
ripple          //滴水效果（不支持过渡方向）
curl            //向上翻一页
un_curl         //向下翻一页
suck            //收缩效果（不支持过渡方向）
cube            //立方体翻滚效果


subType 取值范围：


from_right      //从右边开始动画
from_left       //从左边开始动画
from_top        //从顶部开始动画
from_bottom     //从底部开始动画


（Android系统flip，ripple，curl，un_curl，suck，cube 类型不支持）

callback(ret, err)

ret：

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

示例代码

api.openWidget({
    id: 'A00000001',
    animation: {
        type: 'flip',
        subType: 'from_bottom',
        duration: 500
    }
}, function(ret, err) {
    if (ret) {
        api.alert({
            msg:JSON.stringify(ret)
        });
    } else {
       api.alert({
            msg:JSON.stringify(err)
        });
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本