setBlurEffect

对当前页面或应用设置模糊效果

该方法只支持iOS 8及以上系统

setBlurEffect({params})

params

style：

• 类型：字符串
• 默认值：无
• 描述：模糊效果风格样式，传none时表示移除模糊效果
• 取值范围

none            //移除模糊效果
extra_light     //模糊区域比底层视图的颜色更淡
light           //模糊区域与底层视图的色调近似
dark            //模糊区域比底层视图的颜色更深
regular         //适应界面风格的常规模糊样式，只支持iOS 10及以上系统
prominent       //适应界面风格，使内容更加突出，只支持iOS 10及以上系统

global：

• 类型：布尔
• 默认值：false
• 描述：（可选项）false时表示对当前页面添加模糊效果，true时表示对整个应用窗口添加模糊效果

alpha：

• 类型：数字
• 默认值：1
• 描述：（可选项）模糊区域透明度，介于0和1之间

borderRadius：

• 类型：数字
• 默认值：0
• 描述：（可选项）模糊区域圆角半径

animation：

• 类型：JSON 对象
• 默认值：无
• 描述：（可选项）动画参数，设置模糊渐变效果，只支持iOS 9及以上系统
• 内部字段：

{
    delay:               //动画延迟执行时间，单位毫秒，默认值0，数字类型
    duration:            //动画执行时间，单位毫秒，默认值0，数字类型
    curve:               //动画曲线类型，默认值ease_in_out，字符串类型
}


curve 取值范围：


ease_in_out     //开始和结束时慢
ease_in         //开始时慢
ease_out        //结束时慢
linear          //整个动画过程速率一样

rect：

• 类型：JSON 对象
• 默认值：页面区域
• 描述：（可选项）模糊区域
• 内部字段：

{
    x:,                  //左上角x坐标，数字类型
    y:,                  //左上角y坐标，数字类型
    w:,                  //宽度，数字类型
    h:,                  //高度，数字类型
}

示例代码

// 设置应用模糊效果：
api.addEventListener({
   name: 'pause'
}, function(){
   api.setBlurEffect({
       style: 'light',
       global: true
   });
});


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

可用性

iOS系统

可提供的1.2.61及更高版本