SwiftUI 26 기능
개요
iOS 26, iPadOS 26, macOS Tahoe, watchOS 26, visionOS 26의 새로운 SwiftUI 기능에 대한 종합 가이드입니다. Liquid Glass 디자인 시스템부터 리치 텍스트 편집까지, 이러한 개선 사항은 모든 Apple 플랫폼에서 SwiftUI를 더욱 강력하게 만듭니다.
핵심 원칙 저수준 성능 개선부터 사용자 인터페이스의 버튼까지, 시스템 전반에 걸쳐 주요 개선 사항이 있습니다.
이 스킬을 사용해야 할 때
- Liquid Glass 디자인 시스템 채택
- AttributedString으로 리치 텍스트 편집 구현
- WebView로 웹 콘텐츠 임베딩
- 리스트 및 스크롤 성능 최적화
- @Animatable 매크로를 사용한 사용자 정의 애니메이션
- visionOS에서 3D 공간 레이아웃 구축
- SwiftUI Scene을 UIKit/AppKit 앱에 브리징
- 다중 항목 드래그 앤 드롭 구현
- Chart3D로 3D 차트 생성
- visionOS 또는 CarPlay에 위젯 추가
- 슬라이더에 사용자 정의 틱 표시(챕터 마커, 값 표시기)
enabledBounds로 슬라이더 선택 범위 제한- 슬라이더 모양 사용자 정의(썸 가시성, 현재 값 레이블)
- 블러 효과가 있는 고정 세이프 에리어 바 생성
- 인앱 브라우저에서 URL 열기
- 시스템 스타일의 닫기 및 확인 버튼 사용
- 유리 버튼 스타일 적용(iOS 26.1+)
- 버튼 크기 조정 동작 제어
- 컴팩트 검색 툴바 구현
- 텍스트 줄 높이 또는 기준선 간격 조정
시스템 요구 사항
iOS 26+, iPadOS 26+, macOS Tahoe+, watchOS 26+, visionOS 26+
Liquid Glass 디자인 시스템
포괄적인 내용은 axiom-liquid-glass(디자인 원칙, 변형, 검토 압력) 및 axiom-liquid-glass-ref(앱 전체 채택 가이드)를 참조하세요. 이 섹션은 WWDC 256 특정 API만 다룹니다.
자동 채택
iOS 26 SDK로 재컴파일하면 네비게이션 컨테이너, 탭 바, 툴바, 토글, 분할 피커, 슬라이더가 자동으로 새로운 디자인을 채택합니다. 테두리 있는 버튼은 기본적으로 캡슐 모양입니다. 시트는 Liquid Glass 배경을 얻습니다(presentationBackground 사용자 정의를 제거해야 함).
툴바 API(iOS 26)
ToolbarSpacer
.toolbar {
ToolbarItem(placement: .bottomBar) { Button("Archive", systemImage: "archivebox") { } }
ToolbarSpacer(.flexible, placement: .bottomBar) // 항목 분리
ToolbarItem(placement: .bottomBar) { Button("Compose", systemImage: "square.and.pencil") { } }
}
// .fixed는 시각적으로 그룹 분리; .flexible은 항목을 밀어냄(HStack의 Spacer와 유사)
ToolbarItemGroup(시각적 그룹화)
ToolbarItemGroup의 항목은 단일 유리 배경 "알약"을 공유합니다. ToolbarItemPlacement는 시각적 모양을 제어합니다: confirmationAction → glassProminent 스타일링, cancellationAction → 표준 유리. .sharedBackgroundVisibility(.hidden)을 사용하여 항목(예: 아바타)을 그룹 배경에서 제외합니다.
툴바 형태 변환
.toolbar {}를 NavigationStack 자체가 아닌 NavigationStack 내부의 개별 뷰에 첨부합니다. iOS 26은 푸시/팝 중에 뷰별 툴바 간에 형태를 변환합니다. 안정적으로 유지해야 하는 항목(튕김 없음)에는 화면 전체에서 일치하는 ToolbarItem(id:)와 함께 toolbar(id:)를 사용합니다.
// MailboxList
.toolbar(id: "main") {
ToolbarItem(id: "filter", placement: .bottomBar) { Button("Filter") { } }
ToolbarSpacer(.flexible, placement: .bottomBar)
ToolbarItem(id: "compose", placement: .bottomBar) { Button("New Message") { } }
}
// MessageList — "filter" 없음(애니메이션 아웃), "compose" 안정적으로 유지
.toolbar(id: "main") {
ToolbarSpacer(.flexible, placement: .bottomBar)
ToolbarItem(id: "compose", placement: .bottomBar) { Button("New Message") { } }
}
#1 실수: NavigationStack의 툴바 = 형태 변환할 대상 없음.
DefaultToolbarItem
시스템 제공 항목(예: 검색)을 툴바 레이아웃 내에서 재배치합니다.
DefaultToolbarItem(kind: .search, placement: .bottomBar)
// 일치하는 종류의 시스템 기본 배치를 대체
축소된 NavigationSplitView 사이드바에서 사용하여 iPhone에서 어떤 열이 검색을 표시할지 지정합니다. 하위 호환성을 위해 if #available(iOS 26.0, *)로 래핑합니다.
사용자 정의 가능한 툴바
toolbar(id:)를 사용하면 사용자 정의(재배열, 표시/숨기기)가 가능합니다. iPadOS에서는 .secondaryAction 항목만 사용자 정의를 지원합니다. 선택적 항목에는 showsByDefault: false를 사용합니다. macOS 메뉴 항목에는 ToolbarCommands()를 추가합니다.
기타 툴바 기능
.navigationSubtitle("3 unread")— 제목 아래 보조 줄- 툴바 항목의
.badge(3)— 알림 카운트 - 단색 아이콘 렌더링 — 시각적 노이즈 감소; 의미에 맞게 틴트 사용, 장식용 아님
- 스크롤 가장자리 블러 — 코드 없이 자동
하단 정렬 검색
기본 검색 API: axiom-swiftui-search-ref를 참조하세요. 이 섹션은 iOS 26 개선 사항만 다룹니다.
NavigationSplitView {
List { }.searchable(text: $searchText)
}
// iPhone에서는 하단 정렬, iPad에서는 상단 오른쪽(자동)
// placement: .sidebar를 사용하여 iPad에서 사이드바 내장 검색 복원
searchToolbarBehavior(.minimize)— 탭하면 확장되는 컴팩트 검색Tab(role: .search)— 전용 검색 탭; 검색 필드가 탭 바를 대체합니다. swiftui-nav-ref 섹션 5.7 참조
사용자 정의 뷰를 위한 유리 효과
Button("To Top", systemImage: "chevron.up") { scrollToTop() }
.padding()
.glassEffect() // 사용자 정의 컨트롤의 경우 iOS에서 .interactive 추가
GlassEffectContainer— 여러 유리 요소가 근처에 있을 때 필요(유리는 유리를 샘플링할 수 없음)glassEffectID(_:in:)— 네임스페이스를 사용하여 유리 요소 간의 유동적 형태 변환 전환- 시트 형태 변환 —
.matchedTransitionSource+.navigationTransition(.zoom(...))를 사용하여 버튼에서 시트로 형태 변환
버튼 및 컨트롤 변경 사항
- 테두리 있는 버튼의 기본 캡슐 모양(
.buttonBorderShape(.roundedRectangle)으로 재정의) .controlSize(.extraLarge)— 새로운 매우 큰 버튼 크기- 컨테이너의
.controlSize(.small)— iOS 26 이전 밀도 유지 GlassButtonStyle(.clear/.glass/.tint)— 유리 버튼 변형(iOS 26.1+).buttonSizing(.fit/.stretch/.flexible)— 버튼 레이아웃 동작 제어Button(role: .close)/Button(role: .confirm)— 시스템 스타일 닫기/확인.clipShape(.rect(cornerRadius: 12, style: .containerConcentric))— 모서리 동심도- 메뉴: 앞쪽 가장자리에 아이콘, 일관된 iOS/macOS
슬라이더 개선 사항
iOS 26은 사용자 정의 틱 표시, 제한된 선택 범위, 현재 값 레이블, 썸 가시성 제어를 추가합니다.
슬라이더 틱
핵심 타입: SliderTick<V>, SliderTickContentForEach, SliderTickBuilder
// 레이블이 있는 정적 틱
Slider(value: $value, in: 0...10) {
Text("Rating")
} ticks: {
SliderTick(0) { Text("Min") }
SliderTick(5) { Text("Mid") }
SliderTick(10) { Text("Max") }
}
// 컬렉션의 동적 틱
SliderTickContentForEach(stops, id: \.self) { value in
SliderTick(value) { Text("\(Int(value))°").font(.caption2) }
}
// 단계 기반 틱(각 단계 값에 대해 호출됨)
Slider(value: $volume, in: 0...10, step: 2, label: { Text("Volume") }, tick: { value in
SliderTick(value) { Text("\(Int(value))") }
})
API 제약: SliderTickContentForEach는 Data.Element가 SliderTick<V> 값 타입과 일치해야 합니다. 사용자 정의 구조체의 경우 숫자 값을 추출합니다: chapters.map(\.time) 그런 다음 chapters.first(where: { $0.time == time })을 통해 레이블을 조회합니다.
전체 기능 슬라이더
Slider(
value: $rating, in: 0...100,
neutralValue: 50, // 시작점 / 중앙 값
enabledBounds: 20...80, // 선택 가능 범위 제한
label: { Text("Rating") },
currentValueLabel: { Text("\(Int(rating))") },
minimumValueLabel: { Text("0") },
maximumValueLabel: { Text("100") },
ticks: { SliderTick(50) { Text("Mid") } },
onEditingChanged: { editing in print(editing ? "Started" : "Ended") }
)
sliderThumbVisibility
.sliderThumbVisibility(.hidden) — 미디어 진행 표시기 및 최소 UI용 썸 숨기기. 옵션: .automatic, .visible, .hidden. watchOS에서는 항상 표시됩니다.
새로운 뷰 수정자
safeAreaBar
통합 프로그레시브 블러가 있는 고정 바:
List { ForEach(1...20, id: \.self) { Text("\($0). Item") } }
.safeAreaBar(edge: .bottom) {
Text("Bottom Action Bar").padding(.vertical, 15)
}
.scrollEdgeEffectStyle(.soft, for: .bottom) // 또는 .hard
safeAreaInset과 유사하게 작동하지만 블러가 있습니다. 콘텐츠가 아래로 스크롤되는 동안 바는 고정된 상태로 유지됩니다.
onOpenURL 개선
@Environment(\.openURL) var openURL
// openURL(url, prefersInApp: true) — SFSafariViewController 스타일 인앱 브라우저에서 열림
// 기본 Link는 Safari에서 열림; prefersInApp은 사용자를 앱 내에 유지
searchToolbarBehavior
기본 .searchable API는 axiom-swiftui-search-ref를 참조하세요. iOS 26은 다음을 추가합니다:
.searchable(text: $searchText)
.searchToolbarBehavior(.minimize) // 컴팩트 버튼, 탭하면 확장
또한: .searchPresentationToolbarBehavior(.avoidHidingContent)(iOS 17.1+)는 검색 중에도 제목을 계속 표시합니다.
iOS 18~26을 대상으로 하는 앱용 하위 호환 래퍼:
extension View {
@ViewBuilder func minimizedSearch() -> some View {
if #available(iOS 26.0, *) {
self.searchToolbarBehavior(.minimize)
} else { self }
}
}
// 사용법
.searchable(text: $searchText)
.minimizedSearch()
툴바 항목의 가용성 패턴:
.toolbar {
if #available(iOS 26.0, *) {
DefaultToolbarItem(kind: .search, placement: .bottomBar)
ToolbarSpacer(.flexible, placement: .bottomBar)
}
ToolbarItem(placement: .bottomBar) {
NewNoteButton()
}
}
.searchable(text: $searchText)
버튼 역할, GlassButtonStyle, buttonSizing — 위의 Liquid Glass 디자인 시스템 섹션을 참조하세요.
lineHeight(iOS 26)
텍스트 줄 사이의 기준선 간 거리를 설정합니다. .lineSpacing()(한 줄의 아래쪽에서 다음 줄의 위쪽까지 측정)보다 더 직관적입니다.
사전 설정
Text("Lorem ipsum...")
.lineHeight(.loose) // 열린 레이아웃을 위한 간격 증가
.lineHeight(.tight) // 컴팩트 레이아웃을 위한 간격 감소
.lineHeight(.normal) // 포인트 크기 배수 기반 일정한 높이
.lineHeight(.variable) // 높이 계산에 글꼴 메트릭 사용
정밀 제어
// 글꼴 크기에 비례하여 크기 조정
Text("Scales with text size")
.lineHeight(.multiple(factor: 2))
// 고정 증가분으로 포인트 크기 대비
Text("Point-size relative")
.lineHeight(.leading(increase: 30))
// 절대 고정 값 — Dynamic Type으로 크기 조정되지 않음
Text("Fixed height")
.lineHeight(.exact(points: 30))
AttributedString 지원
var s = AttributedString("Paragraph\nwith multiple\nlines.")
s.lineHeight = .exact(points: 32)
s.lineHeight = .multiple(factor: 2.5)
s.lineHeight = .loose
기존 API와 비교
| API | 측정 대상 | 사용 가능 |
|---|---|---|
.lineHeight() | 기준선에서 기준선까지 | iOS 26+ |
.lineSpacing() | 한 줄의 아래쪽에서 다음 줄의 위쪽까지 | iOS 13+ |
.font(.body.leading(.tight)) | 글꼴 수준 leading 사전 설정 | iOS 14+ |
상호 참조 axiom-typography-ref — Dynamic Type, tracking, 국제화를 포함한 전체 타이포그래피 시스템
iPad 개선 사항
메뉴 바
스와이프 다운 메뉴를 통한 일반 작업 접근
.commands {
TextEditingCommands() // macOS 메뉴 바와 동일한 API
CommandGroup(after: .newItem) {
Button("Add Note") {
addNote()
}
.keyboardShortcut("n", modifiers: [.command, .shift])
}
}
// iPad에서 사용자가 아래로 스와이프할 때 메뉴 바 생성
크기 조정 가능한 창
iPad에서 유동적 크기 조정
// 마이그레이션 필요:
// iPadOS 26에서 더 이상 사용되지 않는 속성 목록 키 제거:
// UIRequiresFullscreen (전체 키 더 이상 사용되지 않음, 모든 값)
// 분할 뷰 탐색의 경우 시스템은 크기 조정 중 사용 가능한 공간에 따라
// 자동으로 열을 표시/숨깁니다.
NavigationSplitView {
Sidebar()
} detail: {
Detail()
}
// 크기 조정에 자동으로 적응
참조 "Elevate the design of your iPad app" (WWDC 2025)
macOS 창 개선 사항
동기화된 창 크기 조정 애니메이션
.windowResizeAnchor(.topLeading) // 애니메이션 시작점 조정
// SwiftUI는 이제 콘텐츠 뷰 크기 변경과 창 크기 조정 간의
// 애니메이션을 동기화합니다 - 탭 전환 시 연속성 유지에 유용
성능 개선
리스트 성능(macOS 중심)
대규모 리스트의 대폭 개선
- macOS에서 100,000개 이상 항목의 리스트 로딩 6배 빨라짐
- 대규모 리스트 업데이트 16배 빨라짐
- 더 큰 리스트일수록 더 큰 이점
- 모든 플랫폼(iOS, iPadOS, watchOS)에서 개선 혜택
List(trips) { trip in // 10만 개 이상 항목
TripRow(trip: trip)
}
// macOS에서 6배 더 빠르게 로드, 16배 더 빠르게 업데이트(iOS 26+)
스크롤 성능
드롭된 프레임 감소
SwiftUI는 iOS 및 macOS에서 사용자 인터페이스 업데이트 스케줄링을 개선했습니다. 이는 응답성을 향상시키고 SwiftUI가 다가오는 프레임을 준비하기 위해 더 많은 작업을 수행할 수 있도록 합니다. 전반적으로 높은 프레임 속도로 빠르게 스크롤할 때 앱이 프레임을 드롭할 가능성을 줄입니다.
Lazy 스택이 있는 중첩 ScrollView
사진 캐러셀 및 다중 축 스크롤
ScrollView(.horizontal) {
LazyHStack {
ForEach(photoSets) { photoSet in
ScrollView(.vertical) {
LazyVStack {
ForEach(photoSet.photos) { photo in
PhotoView(photo: photo)
}
}
}
}
}
}
// 중첩 스크롤뷰는 이제 lazy 스택으로 로딩을 적절히 지연시킵니다.
// 사진 캐러셀 구축에 유용
SwiftUI 성능 계측기
Xcode의 새로운 프로파일링 도구
사용 가능한 레인:
- 긴 뷰 본문 업데이트 — 비용이 많이 드는 본문 계산 식별
- 플랫폼 뷰 업데이트 — 추적
@Animatable 매크로
저수준 Animatable 프로토콜 준수를 간소화하는 새로운 매크로입니다. 핵심 Animatable 프로토콜을 준수하는 유형을 선언하는 가장 간단한 방법으로 설계되었습니다.
구문
// 매크로 없음
struct MyContent: Animatable {
var progress: Double = 0
var animatableData: Double {
get { progress }
set { progress = newValue }
}
}
// 매크로 사용
@Animatable struct MyContent {
var progress: Double = 0
}
// 매크로는 애니메이션 가능한 데이터와 속성을 동기화 상태로 유지합니다
여러 속성
@Animatable struct Position {
var x: Double = 0
var y: Double = 0
}
// VectorArithmetic를 구현할 필요 없음 - 매크로가 처리합니다
참조 swiftui-animations-ref — 고급 Shape 및 GeometryEffect 애니메이션 포함
AttributedString 리치 텍스트 편집
TextEditor는 이제 AttributedString에 대한 인라인 리치 텍스트 편집을 지원합니다. 사용자는 글꼴, 색상, 링크, 목록을 선택하고 적용할 수 있습니다. 기존의 일반 텍스트 편집기에서 리치 텍스트 편집기로의 원활한 전환을 위한 현대적인 대체제입니다.
수정자
textSelectionStyle(.regular) — 스타일 선택기 표시(글꼴 선택기, 색상 선택기 등)
@State private var text = AttributedString("")
TextEditor(text: $text)
.textSelectionStyle(.regular)
.font(.body) // 초기 스타일 구성
LinkHandling
TextEditor 첨부를 사용하여 사용자가 만든 링크를 처리합니다:
TextEditor(text: $text)
.textSelectionStyle(.regular)
.onAttribute(attachment: .link) { url in
// 링크 탭 처리
openURL(url)
}
프로그래매틱 리치 텍스트
var s = AttributedString("This is a string")
s.font = .body
s.foregroundColor = .blue
s.link = URL(string: "https://apple.com")
// 수정자 체이닝
s.font = s.font?.bold().italic()
// 범위 기반 스타일링
s[0..<4].foregroundColor = .red
새로운 수정자
.textSelectionStyle(.regular)— iOS 26에서 사용 가능.onAttribute(attachment: .link)— 첨부 링크에 대한 응답
참조 axiom-attributed-string — 고급 구성 포함 전체 문서
WebView 및 WebPage
WebKit 통합의 핵심 유형:
WebPage— 네트워크 콘텐츠(HTTP/HTTPS)를 가리키는 식별자WebView—WebPage를 표시하는 뷰
기본 사용법
import SwiftUI
import WebKit
WebView(request: URLRequest(url: URL(string: "https://apple.com")!))
.frame(height: 400)
고급 컨트롤
상태: idle, loading, finished, failed
@State private var state: WebView.State = .idle
WebView(request: URLRequest(url: url), state: $state)
switch state {
case .loading: ProgressView()
case .finished: Text("Done")
case .failed: Text("Failed to load")
default: EmptyView()
}
3D 공간 레이아웃
visionOS 26의 새로운 Scene3D 및 Layout3DContainer를 사용하면 SwiftUI 뷰와 볼륨을 3D 공간에 배치할 수 있습니다.
OrbitAnimation
공간에서의 부드러운 3D 회전:
OrbitAnimation {
Model3D(named: "Object")
}
Scene3D 종횡비 제어
Scene3D { }
.aspectRatio(.fill)
Layout3DContainer
Layout3DContainer {
Button("Action") { }
.glassBackgroundEffect()
}
Scene 브리징
SceneBridge 및 SceneBridgeProvider는 SwiftUI Scene을 UIKit(또는 AppKit) 앱의 일부로 포함할 수 있게 합니다.
UIKit에 포함
// UIKit 뷰 컨트롤러 내부
let hostingController = UIHostingController(rootView: MySwiftUIScene())
addChild(hostingController)
view.addSubview(hostingController.view)
hostingController.didMove(toParent: self)
SceneBridgeProvider
struct MyScene: Scene {
var body: some Scene {
WindowGroup {
ContentView()
}
.sceneBridgeProvider { context in
// UIKit/AppKit 컨텍스트에 브리지
}
}
}
드래그 앤 드롭 개선
다중 항목 드래그
List(items) { item in
Text(item.name)
.draggable(item, payload: [item.id]) // 페이로드가 있는 다중 드래그
}
향상된 드롭 영역
Color.clear
.dropDestination(for: String.self) { items, location in
// 커스텀 드롭 처리
return true
}
Chart3D
기본 3D 차트
Chart3D {
PointPlot3D(data) { value in
PlotValue3D(x: value.x, y: value.y, z: value.z)
}
.foregroundStyle(.blue.gradient)
}
마커 및 레이블
Chart3D {
PointPlot3D(data) { value in
PlotValue3D(x: value.x, y: value.y, z: value.z)
}
.annotation {
Text("\(value.label)")
}
}
위젯 개선 사항
visionOS 위젯
struct VisionWidget: Widget {
var body: some WidgetConfiguration {
StaticConfiguration(kind: "vision_widget", provider: Provider()) { entry in
WidgetView(entry: entry)
}
.supportedFamilies([.systemSmall, .systemMedium])
}
}
CarPlay 위젯
struct CarPlayWidget: Widget {
var body: some WidgetConfiguration {
StaticConfiguration(kind: "carplay_widget", provider: Provider()) { entry in
CarPlayWidgetView(entry: entry)
}
.supportedFamilies([.carPlay])
}
}
호환성 및 채택 전략
타겟 버전 확인
if #available(iOS 26.0, *) {
// iOS 26+ 전용 API 사용
}
// 컴파일 타임 확인
#if compiler(>=6.2) // Swift 6.2 가정
// iOS 26 API 사용 가능
#endif
하위 호환 래퍼
extension View {
@ViewBuilder func `if`<Content: View>(_ condition: Bool, transform: (Self) -> Content) -> some View {
if condition {
transform(self)
} else {
self
}
}
}
// 사용법:
Text("Content")
.if(#available(iOS 26.0, *)) { view in
view.lineHeight(.loose)
}
참조
axiom-liquid-glass— 디자인 원칙, 변형, 리뷰 압력axiom-liquid-glass-ref— 앱 전체 채택 가이드axiom-swiftui-search-ref— 검색 APIaxiom-typography-ref— 타이포그래피 시스템axiom-attributed-string— AttributedString 참조swiftui-nav-ref— SwiftUI 탐색 참조swiftui-animations-ref— 애니메이션 참조- WWDC 2025 세션: "Elevate the design of your iPad app"