openWidget

打開 Widget，若此 widget 已經(jīng)被打開，則會(huì)把其調(diào)整到最前面顯示

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

params

id：

• 類型：字符串
• 默認(rèn)值：無
• 描述：（可選項(xiàng)）widget的id

path：

• 類型：字符串
• 默認(rèn)值：無
• 描述：（可選項(xiàng)）widget的根目錄，該目錄下面放置有config.xml等文件。通過傳入此字段，可以打開放置在任意位置的widget。注意若傳了id字段，此字段將被忽略

wgtParam：

• 類型：JSON 對(duì)象
• 默認(rèn)值：無
• 描述：（可選項(xiàng)）widget 參數(shù)，在新打開的 widget 里面的頁面中通過 api.wgtParam 獲取

longPressToExit：

• 類型：布爾
• 默認(rèn)值：true
• 描述：（可選項(xiàng)）在新打開的 widget 里面的頁面中是否支持長(zhǎng)按退出，只支持iOS。

animation：

• 類型：JSON 對(duì)象
• 默認(rèn)值：無
• 描述：（可選項(xiàng)）動(dòng)畫參數(shù)，不傳時(shí)使用默認(rèn)動(dòng)畫
• 內(nèi)部字段：

{
    type:"none",                 //動(dòng)畫類型（詳見動(dòng)畫類型常量）
    subType:"from_right",        //動(dòng)畫子類型（詳見動(dòng)畫子類型常量）
    duration:300                 //動(dòng)畫過渡時(shí)間，默認(rèn)300毫秒
}


type 取值范圍：


none            //無動(dòng)畫效果
push            //新視圖將舊視圖推開
movein          //新視圖移到舊視圖上面
fade            //交叉淡化過渡（不支持過渡方向）
flip            //翻轉(zhuǎn)效果
reveal          //將舊視圖移開,顯示下面的新視圖
ripple          //滴水效果（不支持過渡方向）
curl            //向上翻一頁
un_curl         //向下翻一頁
suck            //收縮效果（不支持過渡方向）
cube            //立方體翻滾效果


subType 取值范圍：


from_right      //從右邊開始動(dòng)畫
from_left       //從左邊開始動(dòng)畫
from_top        //從頂部開始動(dòng)畫
from_bottom     //從底部開始動(dòng)畫


（Android系統(tǒng)flip，ripple，curl，un_curl，suck，cube 類型不支持）

callback(ret, err)

ret：

• 類型：JSON 對(duì)象
• 描述：新 widget 關(guān)閉時(shí)候的返回值

示例代碼

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系統(tǒng)，Android系統(tǒng)

可提供的1.0.0及更高版本