SwiftUI Liquid Glass
개요
이 스킬을 사용하여 iOS 26+ Liquid Glass API와 완전히 일치하는 SwiftUI 기능을 구축하거나 검토하세요. native API(glassEffect, GlassEffectContainer, 유리 버튼 스타일)와 Apple 디자인 가이드라인을 우선시합니다. 사용법을 일관되게 유지하고, 필요한 곳에 상호작용을 적용하며, 성능을 고려하세요.
워크플로우 결정 트리
요청에 맞는 경로를 선택하세요:
1) 기존 기능 검토
- Liquid Glass를 사용해야 할 곳과 사용하지 말아야 할 곳을 검사합니다.
- 올바른 수정자 순서, 모양 사용, 컨테이너 배치를 확인합니다.
- iOS 26+ 가용성 처리와 적절한 대체(fallback) 구현을 확인합니다.
2) Liquid Glass를 사용한 기능 개선
- 유리 처리가 필요한 대상 컴포넌트(표면, 칩, 버튼, 카드)를 식별합니다.
- 여러 유리 요소가 공존하는 경우
GlassEffectContainer를 사용하도록 리팩터링합니다. - 탭 가능하거나 포커스 가능한 요소에만 상호작용 유리를 도입합니다.
3) Liquid Glass를 사용한 새 기능 구현
- 먼저 유리 표면과 상호작용을 설계합니다(모양, 중요도, 그룹화).
- 레이아웃/외관 수정자 다음에 유리 수정자를 추가합니다.
- 뷰 계층이 애니메이션과 함께 변경될 때만 모핑 전환을 추가합니다.
핵심 가이드라인
- 사용자 정의 블러보다 native Liquid Glass API를 선호합니다.
- 여러 유리 요소가 공존할 때
GlassEffectContainer를 사용합니다. .glassEffect(...)는 레이아웃 및 시각적 수정자 다음에 적용합니다.- 터치/포인터에 반응하는 요소에는
.interactive()를 사용합니다. - 관련 요소 간에 일관된 모양을 유지하여 통일된 외관을 만듭니다.
#available(iOS 26, *)로 조건을 걸고 비유리 대체(fallback) UI를 제공합니다.
검토 체크리스트
- 가용성:
#available(iOS 26, *)가 대체 UI와 함께 존재하는가? - 구성: 여러 유리 뷰가
GlassEffectContainer로 감싸졌는가? - 수정자 순서:
glassEffect가 레이아웃/외관 수정자 다음에 적용되었는가? - 상호작용:
interactive()는 사용자 상호작용이 있는 곳에만 사용되었는가? - 전환:
glassEffectID가@Namespace와 함께 모핑 전환에 사용되었는가? - 일관성: 기능 전반에 걸쳐 모양, 틴트, 간격이 일치하는가?
구현 체크리스트
- 대상 요소와 원하는 유리 중요도( prominence)를 정의합니다.
- 그룹화된 유리 요소를
GlassEffectContainer로 감싸고 간격을 조정합니다. - 필요에 따라
.glassEffect(.regular.tint(...).interactive(), in: .rect(cornerRadius: ...))를 사용합니다. - 작업 버튼에는
.buttonStyle(.glass)/.buttonStyle(.glassProminent)를 사용합니다. - 뷰 계층이 변경될 때
glassEffectID로 모핑 전환을 추가합니다. - 이전 iOS 버전을 위한 대체 재질(material)과 시각적 구현을 제공합니다.
빠른 코드 조각
다음 패턴을 직접 사용하고 모양, 틴트, 간격을 필요에 맞게 조정하세요.
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 - 최신 API 세부 사항은 Apple 문서를 선호합니다.