SwiftUI Liquid Glass
歸因:複製自 @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()。 - 轉場:使用搭配
@Namespace的glassEffectID實現變形效果。 - 一致性:形狀、色調和間距在功能中保持一致。
實作檢查清單
- 定義目標元素及所需的玻璃突顯程度。
- 將分組的玻璃元素包裹在
GlassEffectContainer中並調整間距。 - 根據需要使用
.glassEffect(.regular.tint(...).interactive(), in: .rect(cornerRadius: ...))。 - 對操作使用
.buttonStyle(.glass)/.buttonStyle(.glassProminent)。 - 當視圖層級變化時,使用
glassEffectID添加變形轉場。 - 為較早的 iOS 版本提供降級材質和視覺效果。
快速範例程式碼
直接使用這些模式,並根據需要調整形狀、色調和間距。
if #available(iOS 26, *) {
Text("你好")
.padding()
.glassEffect(.regular.interactive(), in: .rect(cornerRadius: 16))
} else {
Text("你好")
.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 詳細資訊。