setBlurEffect

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

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

setBlurEffect({params})

params

style：

  • 类型：字符串
  • 默认值：无
  • 描述：模糊效果风格样式，传none时表示移除模糊效果
  • 取值范围
  1. none            //移除模糊效果
  2. extra_light     //模糊区域比底层视图的颜色更淡
  3. light           //模糊区域与底层视图的色调近似
  4. dark            //模糊区域比底层视图的颜色更深
  5. regular         //适应界面风格的常规模糊样式，只支持iOS 10及以上系统
  6. prominent       //适应界面风格，使内容更加突出，只支持iOS 10及以上系统

global：

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

alpha：

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

borderRadius：

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

animation：

  • 类型：JSON 对象
  • 默认值：无
  • 描述：（可选项）动画参数，设置模糊渐变效果，只支持iOS 9及以上系统
  • 内部字段：
  1. {
  2.     delay:               //动画延迟执行时间，单位毫秒，默认值0，数字类型
  3.     duration:            //动画执行时间，单位毫秒，默认值0，数字类型
  4.     curve:               //动画曲线类型，默认值ease_in_out，字符串类型
  5. }
  7. curve 取值范围：
  9. ease_in_out     //开始和结束时慢
  10. ease_in         //开始时慢
  11. ease_out        //结束时慢
  12. linear          //整个动画过程速率一样

rect：

  • 类型：JSON 对象
  • 默认值：页面区域
  • 描述：（可选项）模糊区域
  • 内部字段：
  1. {
  2.     x:,                  //左上角x坐标，数字类型
  3.     y:,                  //左上角y坐标，数字类型
  4.     w:,                  //宽度，数字类型
  5.     h:,                  //高度，数字类型
  6. }

示例代码

  1. // 设置应用模糊效果：
  2. api.addEventListener({
  3.    name: 'pause'
  4. }, function(){
  5.    api.setBlurEffect({
  6.        style: 'light',
  7.        global: true
  8.    });
  9. });
  11. api.addEventListener({
  12.    name: 'resume'
  13. }, function(){
  14.    api.setBlurEffect({
  15.        style: 'none',
  16.        global: true
  17.    });
  18. });

可用性

iOS系统

可提供的1.2.61及更高版本