SwiftUI UI パターン
クイックスタート
目標に応じてトラックを選択してください:
既存プロジェクト
- 機能や画面、および主要な対話モデル(リスト、詳細、エディタ、設定、タブ付き)を特定します。
- リポジトリ内で
rg "TabView\("などで近い例を見つけ、最も近いSwiftUIビューを読みます。 - ローカルな規約に従います:SwiftUIネイティブな状態を優先し、状態は可能な限りローカルに保ち、共有依存関係には環境注入を使用します。
references/components-index.mdから関連するコンポーネントリファレンスを選択し、そのガイダンスに従います。- 小さく焦点を絞ったサブビューとSwiftUIネイティブなデータフローでビューを構築します。
新規プロジェクトのスキャフォールディング
references/app-scaffolding-wiring.mdから始めて、TabView + NavigationStack + シートを配線します。- 提供されたスケルトンに基づいて、最小限の
AppTabとRouterPathを追加します。 - 最初に必要なUI(TabView、NavigationStack、シート)に基づいて、次のコンポーネントリファレンスを選択します。
- 新しい画面が追加されるたびに、ルートとシートの列挙型を拡張します。
従うべき一般的なルール
- 最新のSwiftUI状態(
@State、@Binding、@Observable、@Environment)を使用し、不必要なビューモデルを避けます。 - コンポジションを優先し、ビューは小さく焦点を絞ったものにします。
.taskと明示的なローディング/エラー状態で async/await を使用します。- レガシーファイルを編集する場合のみ、既存のレガシーパターンを維持します。
- プロジェクトのフォーマッターとスタイルガイドに従います。
- シート:状態が選択されたモデルを表す場合は、
.sheet(isPresented:)よりも.sheet(item:)を優先します。シートの本文内でif letの使用は避けます。シートは自身のアクションを所有し、onCancel/onConfirmクロージャを転送する代わりに、内部でdismiss()を呼び出す必要があります。
新しいSwiftUIビューのワークフロー
- ビューの状態とその所有場所を定義します。
@Environmentを介して注入する依存関係を特定します。- ビュー階層をスケッチし、繰り返し部分をサブビューに抽出します。
- 必要に応じて
.taskと明示的な状態列挙型を使用して非同期ローディングを実装します。 - 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を新しいエントリで更新します。