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 は変更されたプロパティを読み取るビューのみを再レンダリングします:
@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 を使用するビュー
struct ItemListView: View {
@State private var viewModel: ItemListViewModel
init(viewModel: ItemListViewModel = ItemListViewModel()) {
_viewModel = State(initialValue: viewModel)
}
var body: some View {
List(viewModel.items) { item in
ItemRow(item: item)
}
.searchable(text: $viewModel.searchText)
.overlay { if viewModel.isLoading { ProgressView() } }
.task { await viewModel.load() }
}
}
環境注入
@EnvironmentObject を @Environment に置き換えます:
// 注入
ContentView()
.environment(authManager)
// 利用
struct ProfileView: View {
@Environment(AuthManager.self) private var auth
var body: some View {
Text(auth.currentUser?.name ?? "ゲスト")
}
}
ビュー構成
サブビューを抽出して無効化を制限する
ビューを小さく焦点を絞った構造体に分割します。状態が変化したとき、その状態を読み取るサブビューのみが再レンダリングされます:
struct OrderView: View {
@State private var viewModel = OrderViewModel()
var body: some View {
VStack {
OrderHeader(title: viewModel.title)
OrderItemList(items: viewModel.items)
OrderTotal(total: viewModel.total)
}
}
}
再利用可能なスタイリングのための ViewModifier
struct CardModifier: ViewModifier {
func body(content: Content) -> some View {
content
.padding()
.background(.regularMaterial)
.clipShape(RoundedRectangle(cornerRadius: 12))
}
}
extension View {
func cardStyle() -> some View {
modifier(CardModifier())
}
}
ナビゲーション
型安全な NavigationStack
プログラムによる型安全なルーティングには NavigationStack と NavigationPath を使用します:
@Observable
final class Router {
var path = NavigationPath()
func navigate(to destination: Destination) {
path.append(destination)
}
func popToRoot() {
path = NavigationPath()
}
}
enum Destination: Hashable {
case detail(Item.ID)
case settings
case profile(User.ID)
}
struct RootView: View {
@State private var router = Router()
var body: some View {
NavigationStack(path: $router.path) {
HomeView()
.navigationDestination(for: Destination.self) { dest in
switch dest {
case .detail(let id): ItemDetailView(itemID: id)
case .settings: SettingsView()
case .profile(let id): ProfileView(userID: id)
}
}
}
.environment(router)
}
}
パフォーマンス
大規模なコレクションには Lazy コンテナを使用する
LazyVStack と LazyHStack は表示時にのみビューを作成します:
ScrollView {
LazyVStack(spacing: 8) {
ForEach(items) { item in
ItemRow(item: item)
}
}
}
安定した識別子
ForEach では常に安定した一意の ID を使用します。配列インデックスは避けてください:
// Identifiable 準拠または明示的な id を使用
ForEach(items, id: \.stableID) { item in
ItemRow(item: item)
}
body 内での高負荷処理を避ける
body内で I/O、ネットワーク呼び出し、重い計算を行わない- 非同期処理には
.task {}を使用 – ビューが非表示になると自動的にキャンセルされます - スクロールビューでは
.sensoryFeedback()と.geometryGroup()を控えめに使用する - リスト内での
.shadow()、.blur()、.mask()を最小限にする – これらはオフスクリーンレンダリングを引き起こします
Equatable 準拠
ボディが重いビューの場合、Equatable に準拠して不要な再レンダリングをスキップします:
struct ExpensiveChartView: View, Equatable {
let dataPoints: [DataPoint] // DataPoint は Equatable に準拠している必要があります
static func == (lhs: Self, rhs: Self) -> Bool {
lhs.dataPoints == rhs.dataPoints
}
var body: some View {
// 複雑なチャートレンダリング
}
}
プレビュー
インラインモックデータと #Preview マクロを使用して迅速なイテレーションを実現します:
#Preview("空の状態") {
ItemListView(viewModel: ItemListViewModel(repository: EmptyMockRepository()))
}
#Preview("データ読み込み済み") {
ItemListView(viewModel: ItemListViewModel(repository: PopulatedMockRepository()))
}
避けるべきアンチパターン
- 新しいコードで
ObservableObject/@Published/@StateObject/@EnvironmentObjectを使用する –@Observableに移行してください bodyやinitに直接 async 処理を記述する –.task {}または明示的なロードメソッドを使用してください- データを所有しない子ビュー内で
@Stateとしてビューモデルを作成する – 親から渡してください - 条件付きビューに
AnyViewの型消去を使用する –@ViewBuilderまたはGroupを優先してください - アクターとのデータ受け渡し時に
Sendable要件を無視する
参考文献
actor ベースの永続化パターンについては swift-actor-persistence スキルを参照してください。
プロトコルベースの DI と Swift Testing を使ったテストについては swift-protocol-di-testing スキルを参照してください。