setBlurEffect

對(duì)當(dāng)前頁面或應(yīng)用設(shè)置模糊效果

該方法只支持iOS 8及以上系統(tǒng)

setBlurEffect({params})

params

style：

• 類型：字符串
• 默認(rèn)值：無
• 描述：模糊效果風(fēng)格樣式，傳none時(shí)表示移除模糊效果
• 取值范圍

none            //移除模糊效果
extra_light     //模糊區(qū)域比底層視圖的顏色更淡
light           //模糊區(qū)域與底層視圖的色調(diào)近似
dark            //模糊區(qū)域比底層視圖的顏色更深
regular         //適應(yīng)界面風(fēng)格的常規(guī)模糊樣式，只支持iOS 10及以上系統(tǒng)
prominent       //適應(yīng)界面風(fēng)格，使內(nèi)容更加突出，只支持iOS 10及以上系統(tǒng)

global：

• 類型：布爾
• 默認(rèn)值：false
• 描述：（可選項(xiàng)）false時(shí)表示對(duì)當(dāng)前頁面添加模糊效果，true時(shí)表示對(duì)整個(gè)應(yīng)用窗口添加模糊效果

alpha：

• 類型：數(shù)字
• 默認(rèn)值：1
• 描述：（可選項(xiàng)）模糊區(qū)域透明度，介于0和1之間

borderRadius：

• 類型：數(shù)字
• 默認(rèn)值：0
• 描述：（可選項(xiàng)）模糊區(qū)域圓角半徑

animation：

• 類型：JSON 對(duì)象
• 默認(rèn)值：無
• 描述：（可選項(xiàng)）動(dòng)畫參數(shù)，設(shè)置模糊漸變效果，只支持iOS 9及以上系統(tǒng)
• 內(nèi)部字段：

{
    delay:               //動(dòng)畫延遲執(zhí)行時(shí)間，單位毫秒，默認(rèn)值0，數(shù)字類型
    duration:            //動(dòng)畫執(zhí)行時(shí)間，單位毫秒，默認(rèn)值0，數(shù)字類型
    curve:               //動(dòng)畫曲線類型，默認(rèn)值ease_in_out，字符串類型
}


curve 取值范圍：


ease_in_out     //開始和結(jié)束時(shí)慢
ease_in         //開始時(shí)慢
ease_out        //結(jié)束時(shí)慢
linear          //整個(gè)動(dòng)畫過程速率一樣

rect：

• 類型：JSON 對(duì)象
• 默認(rèn)值：頁面區(qū)域
• 描述：（可選項(xiàng)）模糊區(qū)域
• 內(nèi)部字段：

{
    x:,                  //左上角x坐標(biāo)，數(shù)字類型
    y:,                  //左上角y坐標(biāo)，數(shù)字類型
    w:,                  //寬度，數(shù)字類型
    h:,                  //高度，數(shù)字類型
}

示例代碼

// 設(shè)置應(yīng)用模糊效果：
api.addEventListener({
   name: 'pause'
}, function(){
   api.setBlurEffect({
       style: 'light',
       global: true
   });
});


api.addEventListener({
   name: 'resume'
}, function(){
   api.setBlurEffect({
       style: 'none',
       global: true
   });
});

可用性

iOS系統(tǒng)

可提供的1.2.61及更高版本