SwiftUI 專家 是做什麼的?
一個 SwiftUI 畫面的成敗取決於狀態所有權:將狀態放在錯誤的位置,每次按鍵都會重新評估整個視圖樹,列表卡頓,動畫撕裂。此技能負責建立與審查 SwiftUI 視圖,確保失效範圍限制在實際讀取變更資料的視圖內,幀預算在滾動時得以維持,且結果預設即具備無障礙性,而非事後補救。
操作流程
依照此順序執行,因為狀態設計決定下游一切——在視圖階層建立後才修正狀態,等於重寫整個階層。
步驟 1:收集輸入
撰寫任何視圖程式碼前先收集。若使用者不清楚,則使用預設值並標註為推測。
- 目標裝置與更新頻率(預設:假設 ProMotion 120Hz iPhone 加上一部 60Hz 基準裝置)。
- 資料形狀:最大列表中有多少項目、資料變更頻率、是否為串流資料。
- 所有權對照表:每個狀態由哪個視圖建立、哪些視圖讀取、哪些視圖修改。
- 超出基本需求的無障礙要求(預設:完整的動態字級 + VoiceOver 支援)。
步驟 2:為每個值選擇狀態所有權
選擇最狹窄且能運作的包裝器:
@State- 區域性、視圖自有、值型別狀態。也是視圖建立的@Observable模型實例的正確擁有者。@Binding- 雙向參考,指向由其他地方擁有的狀態。僅在子視圖會修改時傳遞 Binding;只讀取時傳遞純值。@Observable(Observation 框架)- 模型物件;視圖僅觀察它們實際讀取的屬性,因此失效是基於屬性而非基於物件。@Environment- 依賴注入,向下傳遞服務與共享模型至視圖樹。
規則:狀態存在於所有讀取或寫入該狀態的視圖的最低共同祖先處——不能更低(否則視圖消失時狀態會重置),也不能更高(否則會擴大失效範圍)。
步驟 3:組合視圖以限制失效範圍
- 保持
body精簡;提取子視圖,使變更只影響單一行而不是整個畫面。body若超過約 50 行或三層巢狀,即應考慮拆分。 - 傳遞最小資料給子視圖——傳遞
item.title,而非整個資料儲存庫——這樣只有受影響的視圖會重新渲染。 - 使用
@ViewBuilder輔助方法取代大型巢狀閉包。 - 絕不在
body中執行繁重工作(格式化、排序、篩選、解碼);應在模型中計算,並將完成的值交給視圖。body必須保持在微秒級別,因為在動畫期間它可能每幀都會執行。
步驟 4:列表與幀預算
幀預算為 120Hz 下每幀 8.3ms,60Hz 下每幀 16.7ms——這是該幀在主執行緒上的總時間,不僅是單一行的時間。實務規則:
- 超過約 50 行時使用
List或LazyVStack,以便按需渲染行;純VStack搭配ScrollView會一次性建立所有行。 - 使用資料中的穩定
id(item.id),絕不使用陣列索引或在body中計算的UUID()——不穩定的 id 會破壞行身分識別,導致閃爍、滾動位置遺失以及行狀態遺失。 - 行必須是固定成本:不要在每行中建立日期格式器或解碼圖片;快取格式器,使用
AsyncImage或快取圖片管線。 - 使用 Instruments 的 SwiftUI 模板:在滾動時觀察 view-body 的評估次數。若某種行類型在不相關狀態變更時仍會評估其 body,表示存在狀態所有權錯誤——請修正步驟 2,不要在其周圍使用 memoization。
步驟 5:從狀態驅動動畫
- 從狀態驅動動畫:
withAnimation { model.expanded.toggle() }。 - 偏好使用
.animation(_:value:)並指定特定值,而非隱式全域動畫,後者會讓非預期的東西也產生動畫。 - 使用
matchedGeometryEffect實現共享元素轉場;使用transition實現插入/移除。 - 尊重
accessibilityReduceMotion:當該設定啟用時,用透明度淡入淡出取代移動效果。
步驟 6:無障礙處理
- 添加
accessibilityLabel/accessibilityValue;使用accessibilityElement(children: .combine)將相關元素分組,使一行讀起來像一個句子,而非五個片段。 - 尊重動態字級——使用系統文字樣式,不要用固定框架剪裁文字;請在最大的無障礙字級下驗證。
- 檢查對比度,並為深色模式、大動態字級以及空/載入/錯誤狀態(附範例資料)添加
#Preview變體。
工作範例:狀態所有權,不良 vs 良好
不良——每次按鍵整個畫面都會失效,因為搜尋文字存在於整個視覺樹都觀察的模型中,且行接收了整個資料儲存庫:
@Observable final class ScreenStore {
var searchText = ""
var items: [Item] = []
}
struct ContactList: View {
@State private var store = ScreenStore()
var body: some View {
VStack {
TextField("搜尋", text: $store.searchText)
ForEach(store.items) { item in
ContactRow(store: store, item: item) // 行觀察一切
}
}
}
}
良好——搜尋文字是視圖區域性的,行只取得它們讀取的值,且列表是懶加載且具有穩定 id:
struct ContactList: View {
@State private var searchText = ""
@Environment(ContactModel.self) private var model
var body: some View {
List(model.filtered(searchText)) { item in
ContactRow(name: item.name, isOnline: item.isOnline)
}
.searchable(text: $searchText)
}
}
struct ContactRow: View {
let name: String
let isOnline: Bool
var body: some View {
Label(name, systemImage: isOnline ? "circle.fill" : "circle")
}
}
在良好版本中輸入文字只會使 List 的內容閉包以及那些因篩選而改變所屬關係的行失效——不影響其他東西。
交付物
產出可運作的 SwiftUI 視圖程式碼,以及一段描述狀態對照表的段落,說明每個狀態的:擁有者、包裝器、以及哪些視圖讀取或寫入它。對於程式碼審查,產出一份按幀預算影響排序的發現清單,每個發現附帶修正方式。
請勿
- 絕不在
body評估期間修改狀態——這會導致迴圈或觸發未定義行為警告。 - 不要在
onAppear中使用原始Task執行非同步工作——請使用.task {},它會在不可見時自動取消。 - 不要將視圖型別(
Color、Image、AnyView)放入模型中;模型必須在沒有 UI 的情況下仍可測試。 - 不要「為求簡潔」將所有狀態提升到一個畫面層級的儲存庫——這正是導致每次按鍵都重繪畫面的模式。
- 不要在使用
equatable()或快取來修正所有權錯誤之前掩蓋失效問題;該錯誤會在觀察同一物件的下一個視圖中再次浮現。 - 不要在文字上使用固定框架——動態字級會將它裁剪。
品質標準
一個完成的視圖必須符合以下條件:
- 每個狀態都只有一個擁有者,且使用最狹窄且能運作的包裝器。
- Instruments 顯示行 body 僅在其自身資料變更時才被評估。
- 滾動預期最大的列表時,在 60Hz 基準裝置上能維持幀預算。
- 長生命週期的狀態被提升到任何可能消失的視圖之上,使其在導覽後仍然存活。
- 處理了鍵盤迴避與安全區域(
safeAreaInset、scrollDismissesKeyboard)。 - VoiceOver 能讀取每個互動元素且帶有意義的標籤;佈局在最大的動態字級下仍能存活;
reduceMotion受到尊重。 - 存在載入、空、錯誤、深色模式以及大字級狀態的預覽畫面。
若需進行超出單一畫面的應用程式層級效能分析,請搭配 mobile-perf-profiler。