This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.
Expo GlassEffect
使用 iOS 原生 UIVisualEffectView 渲染液态玻璃效果的 React 组件。
重要
GlassView仅在 iOS 26 及以上版本可用。在不支持的平台上,它将回退到常规的View。
使用 UIVisualEffectView 渲染原生 iOS 液态玻璃效果的 React 组件。支持可自定义的玻璃样式和色调颜色。
🌐 React components that render native iOS liquid glass effect using UIVisualEffectView. Supports customizable glass styles and tint color.
安装
🌐 Installation
If you are installing this in an existing React Native app, make sure to install expo in your project.
用法
🌐 Usage
GlassView
GlassView 组件渲染原生 iOS 玻璃效果。它支持不同的玻璃效果样式,并且可以通过着色颜色进行自定义,以满足各种美学需求。
🌐 The GlassView component renders the native iOS glass effect. It supports different glass effect styles and can be customized with tint colors for various aesthetic needs.
GlassContainer
GlassContainer 组件允许你将多个玻璃视图组合成一个整体效果。
🌐 The GlassContainer component allows you to combine multiple glass views into a combined effect.
动画玻璃效果风格
🌐 Animated glass effect style
glassEffectStyle 属性接受一个包含 animate 和 animationDuration 属性的配置对象,用于在玻璃效果样式之间进行原生动画过渡。这是淡入/淡出玻璃效果的推荐方法,而无需修改 opacity。
🌐 The glassEffectStyle prop accepts a config object with animate and animationDuration properties to natively animate transitions between glass styles. This is the recommended way to fade in/out the glass effect without modifying opacity.
不透明度动画解决方法
🌐 Opacity animation workaround
苹果不建议在 GlassView 或其父视图上将 opacity 值设低于 1,详情请参见 设置正确的 alpha 值。在非常低的透明度下,玻璃效果不会渲染。如果仍想动画化透明度,可以使用 Reanimated 动画一个封装视图的透明度,同时在所需样式和 'none' 之间切换 glassEffectStyle。
🌐 Apple does not recommend opacity values below 1 on GlassView or its parent views, as described in Set the correct alpha value. At very low opacity, the glass effect does not render. To animate opacity anyway, use Reanimated to animate a wrapper view's opacity while toggling the glassEffectStyle between the desired style and 'none'.
isLiquidGlassAvailable
isLiquidGlassAvailable 函数允许你检查编译后的应用中是否可用 Liquid Glass 效果。它会验证系统和编译器版本,以及 Info.plist 设置。
🌐 The isLiquidGlassAvailable function let's you check, if the Liquid Glass effect is available in the compiled application.
It validates the system and compiler versions, as well as the Info.plist settings.
import { Text } from 'react-native'; import { isLiquidGlassAvailable } from 'expo-glass-effect'; export default function CheckLiquidGlass() { return ( <Text> {isLiquidGlassAvailable() ? 'Liquid Glass effect is available' : 'Liquid Glass effect is not available'} </Text> ); }
isGlassEffectAPIAvailable
isGlassEffectAPIAvailable 函数用于检查设备在运行时是否可以使用 Liquid Glass API。
🌐 The isGlassEffectAPIAvailable function checks whether the Liquid Glass API is available at runtime on the device.
警告 添加此 API 是因为某些 iOS 26 测试版没有可用的 Liquid Glass API,这可能导致崩溃。在你的应用中使用
GlassView之前,你应先检查以确保兼容性。更多信息,请参见 GitHub issue #40911。
import { Text } from 'react-native'; import { isGlassEffectAPIAvailable } from 'expo-glass-effect'; export default function CheckGlassEffectAPI() { return ( <Text> {isGlassEffectAPIAvailable() ? 'Glass Effect API is available' : 'Glass Effect API is not available'} </Text> ); }
应用接口
🌐 API
import { GlassView, GlassContainer, isLiquidGlassAvailable, isGlassEffectAPIAvailable, } from 'expo-glass-effect';
No API data file found, sorry!