SwiftUI Liquid Glass
Attribution: 从@Dimillian的Dimillian/Skills复制(2025-12-31)。
概述
使用此技能来构建或审查完全符合iOS 26+ Liquid Glass API的SwiftUI功能。优先使用原生API(glassEffect、GlassEffectContainer、玻璃按钮样式)和Apple的设计指南。保持用法一致性,必要时添加交互,并关注性能。
工作流决策树
根据请求选择匹配的路径:
1) 审查现有功能
- 检查应在何处使用Liquid Glass以及何处不应使用。
- 验证正确的修饰符顺序、形状用法和容器放置。
- 检查iOS 26+的可用性处理并确保有合理的后备方案。
2) 使用Liquid Glass改进现有功能
- 确定需要玻璃效果的目标组件(表面、标签、按钮、卡片)。
- 当出现多个玻璃元素时,重构为使用
GlassEffectContainer。 - 仅为可点按或可聚焦的元素引入交互式玻璃效果。
3) 使用Liquid Glass实现新功能
- 首先设计玻璃表面和交互(形状、突出程度、分组)。
- 在布局/外观修饰符之后添加玻璃修饰符。
- 仅在视图层次结构随动画变化时添加变形过渡。
核心指南
- 优先使用原生Liquid Glass API而非自定义模糊。
- 当多个玻璃元素共存时使用
GlassEffectContainer。 - 在布局和视觉修饰符之后应用
.glassEffect(...)。 - 对响应触摸/指针的元素使用
.interactive()。 - 保持相关元素之间的形状一致,以获得统一的外观。
- 使用
#available(iOS 26, *)进行门控,并提供非玻璃后备方案。
审查清单
- 可用性: 存在
#available(iOS 26, *)并带有后备UI。 - 组合: 多个玻璃视图包裹在
GlassEffectContainer中。 - 修饰符顺序:
glassEffect在布局/外观修饰符之后应用。 - 交互性: 仅在存在用户交互的地方使用
interactive()。 - 过渡: 使用
glassEffectID配合@Namespace实现变形效果。 - 一致性: 整个功能中形状、色调和间距保持一致。
实现清单
- 定义目标元素和期望的玻璃突出程度。
- 将分组的玻璃元素包裹在
GlassEffectContainer中并调整间距。 - 根据需要使用
.glassEffect(.regular.tint(...).interactive(), in: .rect(cornerRadius: ...))。 - 为操作按钮使用
.buttonStyle(.glass)/.buttonStyle(.glassProminent)。 - 当层级变化时,使用
glassEffectID添加变形过渡。 - 为较旧的iOS版本提供后备材质和视觉样式。
快速代码片段
直接使用这些模式,并根据需要调整形状、色调和间距。
if #available(iOS 26, *) {
Text("Hello")
.padding()
.glassEffect(.regular.interactive(), in: .rect(cornerRadius: 16))
} else {
Text("Hello")
.padding()
.background(.ultraThinMaterial, in: RoundedRectangle(cornerRadius: 16))
}
GlassEffectContainer(spacing: 24) {
HStack(spacing: 24) {
Image(systemName: "scribble.variable")
.frame(width: 72, height: 72)
.font(.system(size: 32))
.glassEffect()
Image(systemName: "eraser.fill")
.frame(width: 72, height: 72)
.font(.system(size: 32))
.glassEffect()
}
}
Button("Confirm") { }
.buttonStyle(.glassProminent)
资源
- 参考指南:
references/liquid-glass.md - 优先使用Apple文档获取最新的API详情。