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("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 문서를 선호합니다.