SuperAPI AI 工具集

swiftui-liquid-glass

通用与其它

查看项目

更新于 10-15 21:12

技能介绍

用途:本技能用于在 SwiftUI 中实现、审查或改进 iOS 26+ 的 Liquid Glass 效果。Liquid Glass 是随 Apple 平台 26 引入的动态半透明材质,使用当前 SDK 构建时,标准 SwiftUI 栏与展示视图会自动采用它;自定义玻璃应仅用于功能性控件与导航表面,而非一般内容背景。完整 API 参考见 references/liquid-glass.md。

主要能力:工作流分三条路径——实现新功能、改进现有功能、审查既有用法。核心 API 包括 .glassEffect(:in:),默认使用 .regular 变体与 Capsule 形状;Glass 结构提供 .regular、.clear、.identity、.tint(:)、.interactive(:),可链式组合如 .regular.tint(.blue).interactive()。GlassEffectContainer 包裹多个玻璃视图以共享渲染、混合与形变,其 spacing 控制邻近玻璃形状开始混合的时机。形变与转场修饰符有 glassEffectID(:in:)、glassEffectUnion(id:namespace:)、glassEffectTransition(_:),近距效果用 .matchedGeometry,远距插入/移除用 .materialize。按钮样式提供 .glass、.glassProminent 与可配置的 .glass(.clear)。相关 iOS 26 API 还包括 scrollEdgeEffectStyle、backgroundExtensionEffect、ToolbarSpacer。

使用方式:应用 .glassEffect() 须放在布局与外观修饰符之后;.interactive() 仅用于可点击/可聚焦元素;形变转场修饰符应加在插入或移除的玻璃子视图上,而非始终存在的容器上;用 if #available(iOS 26, *) 做可用性门控并提供回退。

适用场景:浮动控件、自定义栏、瞬态控件等。

限制与注意事项:避免用玻璃装饰静态内容;只读状态不应使用 .interactive() 或占用操作槽位;相关混合/形变元素应共用同一个 GlassEffectContainer,避免嵌套容器;需测试“降低透明度”“减弱动态效果”与对比度;.clear 玻璃在明亮背景下需加调暗层或改用更不透明样式;玻璃效果数量应受控以保证性能;传给 glassEffectID / glassEffectUnion 的 ID 需为 Sendable。