【Swift】.scrollTargetLayout とは?使い方や引数、活用シーンをわかりやすく解説!

2025.08.23 2025.08.23

SwiftUIでスクロール可能なレイアウトを作成する際に、特定の要素にスナップするような動作を実現したいときに便利なのが .scrollTargetLayout() です。

カードビューやページネーションなど、ユーザーが自然にコンテンツを閲覧できるスクロール体験を提供する場面で、システム標準のスナップ機能を簡潔に導入できます。

この記事では .scrollTargetLayout() の基本的な意味や使い方、主要な引数の意味、活用シーン、注意点までをわかりやすく丁寧に解説します。

.scrollTargetLayout() とは？

.scrollTargetLayout() は SwiftUIにおけるモディファイアの一種で、スクロール可能なコンテナ内の子要素に対してスナップ動作を提供します。

つまり、「スクロール中の要素が自動的に適切な位置に収まる」機能と「スムーズなスクロール体験」をセットで簡単に実現できる仕組みです。

従来であれば複雑なジェスチャー処理や位置計算を自分で実装する必要がありました。

しかし、SwiftUIでは .scrollTargetLayout() を書くだけで自然なスナップ動作を実装できます。

具体例：カードビューのスナップスクロール

このサンプルコードは、横スクロール可能なカードビューで、各カードが画面の中央にスナップする動作を示しています。

ユーザーがスクロールを止めると、最も近いカードが自動的に中央に配置されます。

import SwiftUI

struct ContentView: View {
    let colors: [Color] = [.red, .blue, .green, .orange, .purple, .pink]
    
    var body: some View {
        ScrollView(.horizontal, showsIndicators: false) {
            LazyHStack(spacing: 20) {
                ForEach(colors.indices, id: \.self) { index in
                    RoundedRectangle(cornerRadius: 15)
                        .fill(colors[index])
                        .frame(width: 280, height: 200)
                        .overlay(
                            Text("カード \(index + 1)")
                                .font(.title)
                                .foregroundColor(.white)
                                .bold()
                        )
                }
            }
            .padding(.horizontal, 20)
            .scrollTargetLayout()
        }
        .scrollTargetBehavior(.viewAligned)
        .scrollPosition(id: .constant(0))
    }
}

import SwiftUI

struct ContentView: View {

let colors: [Color] = [.red, .blue, .green, .orange, .purple, .pink]

var body: some View {

ScrollView(.horizontal, showsIndicators: false) {

LazyHStack(spacing: 20) {

ForEach(colors.indices, id: \.self) { index in

RoundedRectangle(cornerRadius: 15)

.fill(colors[index])

.frame(width: 280, height: 200)

.overlay(

Text("カード \(index + 1)")

.font(.title)

.foregroundColor(.white)

.bold()

)

}

.padding(.horizontal, 20)

.scrollTargetLayout()

}

.scrollTargetBehavior(.viewAligned)

.scrollPosition(id: .constant(0))

}

この例では、各カードが画面幅に近いサイズで表示され、スクロール時に自動的に中央にスナップします。

.scrollTargetLayout() を LazyHStack に適用することで、各子要素（カード）がスクロールターゲットとして認識され、.scrollTargetBehavior(.viewAligned) と組み合わせることで自然なスナップ動作を実現しています。

主要な組み合わせパターンと使い方

.scrollTargetLayout() を正しく使うには、関連するモディファイアとの組み合わせを理解しておくことが重要です。

これらのモディファイアは単体では完全に機能せず、適切に組み合わせることで初めて期待通りのスクロール体験を実現できます。

各モディファイアは異なる役割を持ち、組み合わせることで完全なスナップスクロール機能が実現されます。

基本的な組み合わせ

モディファイア	説明	必須度
`.scrollTargetLayout()`	子要素をスクロールターゲットとして認識させる	必須
`.scrollTargetBehavior()`	スナップ動作の種類を指定	推奨
`.scrollPosition()`	現在の位置を管理・制御	オプション

この表の通り、.scrollTargetLayout() は必須で、.scrollTargetBehavior() と組み合わせることで実用的なスナップ動作が実現できます。

.scrollTargetBehavior()の主要なオプション

.scrollTargetBehavior()で指定できるスナップ動作の種類によって、ユーザーが体験するスクロールの挙動が大きく変わります。

// ビューに合わせてスナップ（最も一般的）
.scrollTargetBehavior(.viewAligned)

// ページング動作（フルサイズでスナップ）
.scrollTargetBehavior(.paging)

// カスタムスナップ動作
.scrollTargetBehavior(.custom)

// ビューに合わせてスナップ（最も一般的）

.scrollTargetBehavior(.viewAligned)

// ページング動作（フルサイズでスナップ）

.scrollTargetBehavior(.paging)

// カスタムスナップ動作

.scrollTargetBehavior(.custom)

.viewAligned は要素のサイズに合わせて自然にスナップし、.paging は画面全体を使ったページ送りのような動作を提供します。

活用シーン

.scrollTargetLayout() はアプリの中で「自然なスクロール体験」を提供したい場面で威力を発揮します。

単なるスクロールに留まらず、UXを大きく向上させる様々な用途で活用できます。

カードビューの横スクロール: 商品カタログやメディアギャラリーでの自然な閲覧体験
オンボーディング画面: ページごとにスナップするチュートリアル画面の実装
タブ切り替え風UI: 複数のビューを横スクロールで切り替える独自タブUI
カレンダーや日付選択: 月や週単位でスナップする直感的なナビゲーション
設定項目の選択: 数値や選択肢をスクロールで選ぶピッカー風UI
コンテンツプレビュー: 記事や動画のプレビューを快適にブラウジング

特に、モバイルアプリにおいて「指で操作しやすく、意図した位置で止まる」スクロール体験を簡単に実現できる点が大きなメリットです。

注意点

便利な .scrollTargetLayout() ですが、使う際にはいくつかの前提条件や注意すべきポイントがあります。

これらを理解しておくことで、予期しない動作や性能問題を防ぐことができます。

システム要件と制限事項

iOS 17 / macOS 14 以降が対応対象（旧OSでは動作しない）
ScrollView 内の直接の子要素（LazyHStack や LazyVStack など）に適用する必要がある
.scrollTargetBehavior() との組み合わせが前提となっている
パフォーマンスを考慮し、大量のデータでは Lazy コンテナの使用を推奨

パフォーマンス考慮事項

子要素の数が多い場合は LazyHStack / LazyVStack を使用
複雑なアニメーションとの組み合わせ時は動作確認を十分に行う
メモリ使用量に注意し、必要に応じて要素のサイズを最適化

まとめ

今回は SwiftUI の .scrollTargetLayout() について詳しく紹介しました。

.scrollTargetLayout() はスクロール要素に自動スナップ機能を提供するモディファイア
.scrollTargetBehavior() との組み合わせでスナップ動作を制御
カードビューやカタログなど、自然なスクロール体験が必要な多くの場面で活用できる
iOS 17以降の新機能であり、LazyStack との組み合わせが基本

SwiftUIでモダンなスクロール体験を実装する際には、.scrollTargetLayout() を使うことで直感的かつ宣言的に実装できます。

ユーザーが快適に操作できるスクロールUIを作成したい場面で、ぜひ活用してみてくださいね！