Skip to content

UIBlurEffect.effectWithStyle() 静态方法 ​

UIBlurEffect.effectWithStyle() 静态方法造一个指定样式的模糊效果。

语法 ​

UIBlurEffect.effectWithStyle(style)

参数 ​

style

模糊的样式,字符串。分三组。各样式的实际观感未在模拟器验证,下表的说明来自 Apple 的头文件和样式的名字。

style效果
'systemUltraThinMaterial'材质,最薄:后面的画面透出来最多。跟随深浅色模式
'systemThinMaterial'材质,较薄。跟随深浅色模式
'systemMaterial'材质,标准厚度。跟随深浅色模式
'systemThickMaterial'材质,较厚:后面的画面透出来最少。跟随深浅色模式
'systemChromeMaterial'材质,名字里的 chrome 指工具栏这类界面外框。跟随深浅色模式
上面五个加 Light 后缀,如 'systemMaterialLight'同一种材质,固定为浅色模式下的样子,不跟随深浅色模式
上面五个加 Dark 后缀,如 'systemMaterialDark'同一种材质,固定为深色模式下的样子
'regular'浅色模式下等于 'light',深色模式下等于 'dark'
'prominent'浅色模式下等于 'extraLight',深色模式下等于 'dark'
'extraLight'模糊并盖一层很亮的颜色。不跟随深浅色模式
'light'模糊并盖一层亮的颜色。不跟随深浅色模式
'dark'模糊并盖一层暗的颜色。不跟随深浅色模式

返回值 ​

新建的 UIBlurEffect。每次调用都是新的对象:同一种样式调两次,得到两个不相等的对象。

异常 ​

TypeError

style 不在上表里。报错信息里列出所有可用的值,形如 style has no value "frosted"; expected one of: extraLight / light / dark / …。

示例 ​

js
const blur = UIBlurEffect.effectWithStyle('systemMaterial');
const panel = new UIVisualEffectView(blur);
console.log(panel.effect === blur);

结果:输出 true。模糊效果交给效果视图后,读回来是同一个对象。

对应的 iOS API ​

+[UIBlurEffect effectWithStyle:]。UIBlurEffectStyleSystemMaterial 写成 'systemMaterial',其余同理。tvOS 的 UIBlurEffectStyleExtraDark 在 iOS 上不可用,没有提供。

参见 ​