SwiftUI 視圖重構
概述
為 SwiftUI 視圖套用一致的結構與依賴模式,重點關注順序、Model-View(MV)模式、謹慎的視圖模型處理以及正確的 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。
大型視圖處理
- 當 SwiftUI 視圖檔案超過約 300 行時,使用擴展來分組相關的輔助功能。將非同步函式和輔助函式移至專用的
private擴展中,並使用// MARK: -註解來描述其用途(例如// MARK: - 動作、// MARK: - 子視圖、// MARK: - 輔助功能)。保持主要struct專注於儲存屬性、init 和 body,當檔案較長時,視圖建構計算屬性也透過標記進行分組。