構造体

ScrollViewReader

プロキシを使用し、既知の子ビューへとスクロールして、プログラムによるスクロールを提供するビュー。

宣言

@frozen struct ScrollViewReader<Content> where Content : View

概観

スクロールビューリーダーのコンテンツビュービルダーは、ScrollViewProxy インスタンスを受け取ります。プロキシの scrollTo(_:anchor:) を使用してスクロールを実行します。

以下の例では、色のグラデーションを一緒に表示する 100 個のビューを含む ScrollView を作成します。また、上部と下部にそれぞれ 1 つずつ、合計 2 つのボタンが含まれています。上のボタンは、ScrollViewProxy に、下のボタンへとスクロールするように指示し、その逆も同様です。

@Namespace var topID

@Namespace var bottomID

var body: some View {

ScrollViewReader { proxy in

ScrollView {

Button("Scroll to Bottom") {

withAnimation {

proxy.scrollTo(bottomID)

}

.id(topID)

VStack(spacing: 0) {

ForEach(0..<100) { i in

color(fraction: Double(i) / 100)

.frame(height: 32)

}

Button("Top") {

withAnimation {

proxy.scrollTo(topID)

}

.id(bottomID)

}

func color(fraction: Double) -> Color {

Color(red: fraction, green: 1 - fraction, blue: 0.5)

}

重要

content ビュービルダーの実行中に ScrollViewProxy を使用することはできません。これを行うと、実行時エラーが発生します。代わりに、ジェスチャハンドラやビューの onChange(of:perform:)メソッドなど、content 内で作成されたアクションのみがプロキシを呼び出すことができます。