LiquidGlass(液态玻璃组件)

大约 2 分钟

LiquidGlass(液态玻璃组件)

系统和版本要求

  • 系统版本：iOS 26.0+

  • Kuikly版本：2.5.0+

LiquidGlass 是专门为 iOS 26+ 液态玻璃效果设计的容器组件。其等同于View组件设置 glassEffectIOS() 属性。

组件使用示例open in new window

基础用法

import com.tencent.kuikly.core.views.LiquidGlass

LiquidGlass {
    attr {
        height(60f)
        borderRadius(30f)
    }
    Text {
        attr {
            text("液态玻璃效果")
        }
    }
}

属性

LiquidGlass 支持所有基础属性，还支持以下专有属性：

glassEffectInteractive

控制液态玻璃效果是否响应用户交互。

参数描述类型默认值
isInteractive是否启用交互效果Booleanfalse

glassEffectTintColor

设置液态玻璃效果的色调颜色。

参数描述类型默认值
color色调颜色Color系统默认

glassEffectStyle

设置液态玻璃效果的样式。

参数描述类型默认值
style玻璃效果样式GlassEffectStyleREGULAR

GlassEffectStyle 枚举值：

  • REGULAR - 标准液态玻璃效果
  • CLEAR - 清透液态玻璃效果

事件

LiquidGlass 支持所有基础事件。

注意事项

1. 系统兼容性

使用独立液态玻璃组件时，请做好系统版本检测，确保在 iOS 26+ 系统上使用液态玻璃效果。对于不支持的版本，建议提供降级方案。

import com.tencent.kuikly.core.utils.PlatformUtils

// 推荐做法：检测系统支持
if (PlatformUtils.isLiquidGlassSupported()) {
    LiquidGlass {
        // 液态玻璃实现
    }
} else {
    View {
        attr {
            backgroundColor(Color.GRAY) // 降级方案
        }
        // 相同的子组件
    }
}

2. 背景设置

使用 LiquidGlass 时，避免设置不透明背景色，这会覆盖液态玻璃效果：

LiquidGlass {
    attr {
        // ❌ 错误：会覆盖玻璃效果
        // backgroundColor(Color.RED)
        
        // ✅ 正确：保持透明或不设置
        // backgroundColor(Color.TRANSPARENT)
    }
}

相关组件