SwiftUI UI パターン は何をしますか?
クイックスタート
目標に基づいてトラックを選択してください。
既存のプロジェクト
- フィーチャーまたは画面と、その主要なインタラクションモデル(リスト、詳細、エディタ、設定、タブ)を特定します。
rg "TabView\("などを使用してリポジトリ内の近くの例を見つけ、最も近い SwiftUI ビューを読みます。- ローカルな規約を適用する: SwiftUI ネイティブの状態を優先し、可能な限り状態をローカルに保ち、共有依存関係には環境インジェクションを使用します。
references/components-index.mdから関連するコンポーネントリファレンスを選択し、そのガイダンスに従います。- 小さく焦点を絞ったサブビューと SwiftUI ネイティブのデータフローを使用してビューを構築します。
新規プロジェクトのスキャフォールディング
references/app-scaffolding-wiring.mdから始めて、TabView + NavigationStack + sheets を配線します。- 提供されたスケルトンに基づいて、最小限の
AppTabとRouterPathを追加します。 - 最初に必要な UI に基づいて、次のコンポーネントリファレンスを選択します(TabView、NavigationStack、Sheets)。
- 新しい画面が追加されるにつれて、ルートとシートの enum を拡張します。
従うべき一般ルール
- 最新の SwiftUI 状態(
@State、@Binding、@Observable、@Environment)を使用し、不要な ViewModel を避けます。 - コンポジションを優先し、ビューを小さく焦点を絞ったものに保ちます。
.taskと明示的な読み込み/エラー状態を伴う async/await を使用します。- 既存のレガシーファイルを編集する場合のみ、既存のレガシーパターンを維持します。
- プロジェクトのフォーマッターとスタイルガイドに従います。
- シート: 状態が選択されたモデルを表す場合は、
.sheet(isPresented:)よりも.sheet(item:)を優先します。シート本体内でのif letの使用は避けてください。シートは自身のアクションを所有し、onCancel/onConfirmクロージャを転送する代わりに、内部でdismiss()を呼び出す必要があります。
新しい SwiftUI ビューのワークフロー
- ビューの状態とその所有権の場所を定義します。
@Environmentを介して注入する依存関係を特定します。- ビュー階層をスケッチし、繰り返し部分をサブビューに抽出します。
.taskと必要に応じて明示的な状態 enum を使用して非同期読み込みを実装します。- UI がインタラクティブな場合、アクセシビリティラベルまたは識別子を追加します。
- ビルドで検証し、必要に応じて使用箇所を更新します。
コンポーネントリファレンス
エントリポイントとして references/components-index.md を使用します。各コンポーネントリファレンスには以下を含める必要があります:
- 意図と最適なシナリオ。
- ローカルな規約に沿った最小限の使用パターン。
- 落とし穴とパフォーマンスに関する注意点。
- 現在のリポジトリ内の既存の例へのパス。
シートパターン
アイテム駆動シート(推奨)
@State private var selectedItem: Item?
.sheet(item: $selectedItem) { item in
EditItemSheet(item: item)
}
シートがアクションを所有する
struct EditItemSheet: View {
@Environment(\.dismiss) private var dismiss
@Environment(Store.self) private var store
let item: Item
@State private var isSaving = false
var body: some View {
VStack {
Button(isSaving ? "保存中…" : "保存") {
Task { await save() }
}
}
}
private func save() async {
isSaving = true
await store.save(item)
dismiss()
}
}
新しいコンポーネントリファレンスの追加
references/<component>.mdを作成します。- 短く実用的に保ち、現在のリポジトリ内の具体的なファイルにリンクします。
references/components-index.mdを新しいエントリで更新します。