SwiftUI 뷰 리팩터
출처: @Dimillian의 Dimillian/Skills에서 복사함 (2025-12-31).
개요
SwiftUI 뷰에 일관된 구조와 의존성 패턴을 적용합니다. 순서, MV(Model-View) 패턴, 신중한 뷰 모델 처리, 올바른 Observation 사용에 중점을 둡니다.
핵심 가이드라인
1) 뷰 순서 (위 → 아래)
- Environment
private/publiclet@State/ 기타 저장 속성- 계산된
var(뷰 관련 없음) initbody- 계산된 뷰 빌더 / 기타 뷰 헬퍼
- 헬퍼 / 비동기 함수
2) MV (Model-View) 패턴 선호
- 기본값은 MV: 뷰는 가벼운 상태 표현이며, 모델/서비스가 비즈니스 로직을 소유합니다.
- 오케스트레이션을 위해
@State,@Environment,@Query,task/onChange를 선호합니다. - 서비스와 공유 모델은
@Environment를 통해 주입하고, 뷰를 작고 조합 가능하게 유지합니다. - 뷰 모델을 도입하는 대신 큰 뷰를 하위 뷰로 분할합니다.
3) 큰 body와 뷰 속성 분할
body가 한 화면을 넘거나 여러 논리적 섹션으로 구성된 경우, 더 작은 하위 뷰로 분할합니다.- 큰 계산된 뷰 속성(
var header: some View { ... })이 상태나 복잡한 분기를 포함할 때는 전용View타입으로 추출합니다. - 관련 하위 뷰를 같은 파일에 계산된 뷰 속성으로 유지하는 것은 괜찮습니다. 구조적으로 의미가 있거나 재사용이 필요한 경우에만 독립
View구조체로 추출합니다. - 전체 부모 뷰 상태를 재사용하는 것보다 작은 입력(데이터, 바인딩, 콜백)을 전달하는 것을 선호합니다.
예시 (섹션 추출):
var body: some View {
VStack(alignment: .leading, spacing: 16) {
HeaderSection(title: title, isPinned: isPinned)
DetailsSection(details: details)
ActionsSection(onSave: onSave, onCancel: onCancel)
}
}
예시 (긴 body → 더 짧은 body + 같은 파일의 계산된 뷰):
var body: some View {
List {
header
filters
results
footer
}
}
private var header: some View {
VStack(alignment: .leading, spacing: 6) {
Text(title).font(.title2)
Text(subtitle).font(.subheadline)
}
}
private var filters: some View {
ScrollView(.horizontal, showsIndicators: false) {
HStack {
ForEach(filterOptions, id: \.self) { option in
FilterChip(option: option, isSelected: option == selectedFilter)
.onTapGesture { selectedFilter = option }
}
}
}
}
예시 (복잡한 계산된 뷰 추출):
private var header: some View {
HeaderSection(title: title, subtitle: subtitle, status: status)
}
private struct HeaderSection: View {
let title: String
let subtitle: String?
let status: Status
var body: some View {
VStack(alignment: .leading, spacing: 4) {
Text(title).font(.headline)
if let subtitle { Text(subtitle).font(.subheadline) }
StatusBadge(status: status)
}
}
}
4) 뷰 모델 처리 (이미 존재하는 경우에만)
- 요청이나 기존 코드가 명확히 요구하지 않는 한 뷰 모델을 도입하지 마십시오.
- 뷰 모델이 존재하면 가능한 경우 옵셔널을 제거하십시오.
init을 통해 뷰에 의존성을 전달한 다음, 뷰의init에서 뷰 모델로 전달합니다.bootstrapIfNeeded패턴을 피하십시오.
예시 (Observation 기반):
@State private var viewModel: SomeViewModel
init(dependency: Dependency) {
_viewModel = State(initialValue: SomeViewModel(dependency: dependency))
}
5) Observation 사용
@Observable참조 타입의 경우 루트 뷰에@State로 저장합니다.- 필요에 따라 관찰 가능 객체를 명시적으로 전달하고, 필요하지 않으면 옵셔널 상태를 피합니다.
워크플로우
- 순서 규칙에 맞게 뷰를 재정렬합니다.
- MV 선호:
@State,@Environment,@Query,task,onChange를 사용하여 가벼운 오케스트레이션을 뷰로 이동합니다. - 뷰 모델이 존재하면 옵셔널 뷰 모델을
init에서 초기화된 비옵셔널@State뷰 모델로 교체하고, 뷰의 의존성을 전달합니다. - Observation 사용 확인: 루트
@Observable뷰 모델에는@State를 사용하고, 중복 래퍼는 없어야 합니다. - 동작을 유지: 요청되지 않은 한 레이아웃이나 비즈니스 로직을 변경하지 않습니다.
참고
- 큰 조건문보다 작고 명시적인 헬퍼를 선호합니다.
- 계산된 뷰 빌더는
body아래에, 비뷰 계산된 변수는init위에 유지합니다. - MV 우선 지침과 근거는
references/mv-patterns.md를 참조하십시오.