SwiftUI View Refactor
帰属: @Dimillian の Dimillian/Skills (2025-12-31) よりコピー。
概要
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として保存します。- 必要に応じて Observable を明示的に子ビューに渡します。必要な場合を除き、オプショナルな状態は避けてください。
ワークフロー
- ビューの順序をルールに合わせて並べ替えます。
- MV を優先:
@State、@Environment、@Query、task、onChangeを使用して軽量なオーケストレーションをビューに移動します。 - ビューモデルが存在する場合、オプショナルなビューモデルを、依存関係をビューから受け取って
initで初期化される非オプショナルな@Stateビューモデルに置き換えます。 - Observation の使用法を確認: ルートの
@Observableビューモデルには@Stateを使用し、冗長なラッパーは使用しません。 - 動作を変更しない: 要求がない限り、レイアウトやビジネスロジックを変更しないでください。
注記
- 大きな条件ブロックよりも、小さく明示的なヘルパーを推奨します。
- 算出ビュービルダーは
bodyの下に、非ビューの算出変数はinitの上に配置します。 - MV ファーストのガイダンスと根拠については、
references/mv-patterns.mdを参照してください。