SwiftUI Liquid Glass
概觀
使用此技能來建置或審查完全符合 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("確認") { }
.buttonStyle(.glassProminent)
參考資源
- 參考指南:
references/liquid-glass.md - 推薦查閱 Apple 官方文件以取得最新 API 細節。