Swiftui Patterns

# SwiftUI パターン

Appleプラットフォーム向けのモダンなSwiftUIパターン。宣言的で高性能なユーザーインターフェースを構築するために使用する。Observationフレームワーク、ビュー合成、型安全なナビゲーション、パフォーマンス最適化をカバーする。

## 起動条件

* SwiftUIビューを構築し、状態を管理する場合（`@State`、`@Observable`、`@Binding`）
* `NavigationStack` を使用したナビゲーションフローを設計する場合
* ビューモデルとデータフローを構築する場合
* リストと複雑なレイアウトのレンダリングパフォーマンスを最適化する場合
* SwiftUIで環境値と依存性注入を使用する場合

## 状態管理

### プロパティラッパーの選択

最も適したシンプルなラッパーを選択する：

| ラッパー | 使用場面 |
|---------|----------|
| `@State` | ビューローカルな値型（トグル、フォームフィールド、シート表示） |
| `@Binding` | 親ビューの `@State` への双方向参照 |
| `@Observable` クラス + `@State` | 複数のプロパティを持つ所有モデル |
| `@Observable` クラス（ラッパーなし） | 親ビューから渡される読み取り専用参照 |
| `@Bindable` | `@Observable` プロパティへの双方向バインディング |
| `@Environment` | `.environment()` で注入された共有依存関係 |

### @Observable ViewModel

`ObservableObject` ではなく `@Observable` を使用する——プロパティレベルの変更を追跡するため、SwiftUIは変更されたプロパティを読み取ったビューのみを再レンダリングする：

```swift
@Observable
final class ItemListViewModel {
    private(set) var items: [Item] = []
    private(set) var isLoading = false
    var searchText = ""

    private let repository: any ItemRepository

    init(repository: any ItemRepository = DefaultItemRepository()) {
        self.repository = repository
    }

    func load() async {
        isLoading = true
        defer { isLoading = false }
        items = (try? await repository.fetchAll()) ?? []
    }
}
```

### ViewModelを使用するビュー