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の下に、ビュー以外の計算型varはinitの上に配置します。 - MVファーストのガイダンスと根拠については、
references/mv-patterns.mdを参照してください。
大規模ビューの取り扱い
- SwiftUIビューファイルが約300行を超える場合、拡張機能を使用して関連するヘルパーをグループ化します。非同期関数やヘルパー関数は、専用の
private拡張機能に移動し、その目的を説明する// MARK: -コメント(例:// MARK: - Actions、// MARK: - Subviews、// MARK: - Helpers)で区切ります。メインのstructは格納プロパティ、init、およびbodyに集中させ、ファイルが長い場合はビュー生成計算型varもマークでグループ化します。