SwiftUIのGeometryReaderとScrollViewを基礎から応用まで学び直す：設計と活用事例

SwiftUIのGeometryReaderとScrollViewを基礎から応用まで学び直す：設計と活用事例 Fumiya Sakai extension DC 2025 Day3 @ LINEヤフー
2025/10/03

自己紹介・Fumiya Sakai ・Mobile Application Engineer アカウント: ・Twitter: https://twitter.com/fumiyasac ・Facebook:
https://www.facebook.com/fumiya.sakai.37 ・Github: https://github.com/fumiyasac ・Qiita: https://qiita.com/fumiyasac@github 発表者: ・Born on September 21, 1984 これまでの歩み: Web Designer 2008 ~ 2010 Web Engineer 2012 ~ 2016 App Engineer 2017 ~ Now iOS / Android / sometimes Flutter

技術書典18では新刊をオンライン頒布しましたインプットを整理して次へ繋げる→アウトプットに応用できる様に

iOSDC Japan 2025では原稿を1つ寄稿しています原稿名: 見た目に惑わされないUI設計と実装の勘どころ〜SwiftUI・UIKitで読み解く複雑度の見極め方〜 iOS/Androidで類似したUIを実装する場合に気になるポイントを整理しました

まずは参加者の皆様にお聞きしたいと思います Question. GeometryReaderやUIScrollViewDelegateにどんなイメージがある？ 1. GeometryReaderに関する印象：難しい。（取得値による座標計算の複雑さ / 算出された値の基準がどこなのか分かりにくい / バージョン差異
… ） UIKitに慣れていないと意外と難しい。（座標計算の複雑さやUITableView / UICollectionViewとの組み合わせ） 2. UIScrollViewDelegateに関する印象： ScrollViewで用意されているModifierやScrollViewReaderを併用して応用する事で、様々な目を惹くAnimation やUI表現を作る事が可能ではあるが、Viewの重なり・処理のトリガーを整理する必要がある。 https://www.youtube.com/watch?v=3k7PP6TE1h4 Xcode 16 & iOS 18 での新機能解説 📹 参考動画: SwiftUIで提供されるScrollViewはバージョンアップの度に利用可能な機能が増えている。 scrollViewDidScrollを利用した処理で馴染みはあるが、値を利用して応用する必要がある。

GeometryReaderを活用するケースを深掘りする ScrollViewを応用した複雑なUI実装を実現する際には何かとお世話になるレイアウトの調節だけではなくScroll処理との上手な連動をするための手段としても活用可能。 1. Scroll量に応じたHeaderの縮小・拡大： ScrollView内でGeometryReaderを使って、frame(in: .global).minYを監視しOffset値に応じてHeight値やFontSize値を調整 2. 背景のParallax効果：背景ViewにGeometryReaderを重ね、ScrollOffsetを利用してOffset値やScaleEffect値を変更
3. 動的なLayout調整： geometry.size.widthを使い、しきい値によってLayoutの切り替えやLazyVGridのColumn数を変更 Contents料が多い画面でも省Spaceで情報を表示可能写真やVisualを多用するUIでリッチな見せ方が可能 MultiDevice対応やResponsiveUI設計がシンプルになる

どの様な所に対して難しさを感じるのかを考えてみる SwiftUIを利用した画面構築やUI実装で利用する機会はあるがなかなか難しいこれまでの過去事例からいくつかピックアップして解説できればと思います。 1. 簡単な実装 vs 複雑な実装における難易度とギャップ：簡単な実装であれば、さほど苦労はしない事も多いかもしれません。しかしながら、Animation表現等にも関連がある様な複雑な実装を考える際では、難易度が一気に上がってしまう事は多いと思います。 2.
座標基準をどこに設定するか？という問題： GeometryReaderでの表現を考える際に注意が必要なのは「座標基準をどこに設定するか？」という点にあると考えています。座標位置の基準を誤ってしまうと、位置合わせやデバッグが困難になる場合があります。 3. 意外といい感じの事例が思い浮かばない？という問題：私も最初GeometryReaderに関するサンプル実装を探していた際に、自分に合った難易度をものを探し当てる・コードの概要とポイントを読み解く事に苦労しました。過去に取り組んだ打開策についても今回お伝えします。

ScrollやGeometryReaderを利用した表現事例(1) // GrometryReaderを利用した背景用サムネイル画像Parallax表現部分 GeometryReader { geometry in getBackgroundViewBy( geometry: geometry,
backgroundImageUrl: backgroundImageUrl ) } @ViewBuilder private func getBackgroundViewBy( geometry: GeometryProxy, backgroundImageUrl: URL? ) -> some View { if geometry.frame(in: .global).minY <= 0 { ZStack { KFImage(backgroundImageUrl).resizable() .aspectRatio(contentMode: .fill) Rectangle() .foregroundColor(cellThumbnailMaskColor) } .frame(width: geometry.size.width, height: geometry.size.height) } else { ZStack { KFImage(backgroundImageUrl).resizable() .aspectRatio(contentMode: .fill) Rectangle() .foregroundColor(cellThumbnailMaskColor) } .offset(y: -geometry.frame(in: .global).minY) .frame( width: geometry.size.width, height: geometry.size.height + geometry.frame(in: .global).minY ) } } // (1) ScrollViewにおいて一番上にある状態から更に下方向へスクロールした場合 // 👉 Header用のサムネイル画像が拡大される様な形の表現をするための処理 // (2) 上方向へスクロールした場合 // 👉 画像の比率を維持してピッタリと画面にはまる大きさを保持した状態でスクロールに追従させるための処理上端が固定されてサムネイルが拡大 proxy.sizeの値を適用する事で実現する ※不合致時は通常Scroll

ScrollやGeometryReaderを利用した表現事例(2) 一番下の要素表示時に次のPage要素を表示 https://medium.engineering/how-to-do-pagination-in-swiftui-04511be7fbd1 参考資料: https://apoorv487.medium.com/pagination-in-swiftui-5a90ea952876 ScrollView { ForEach(archiveCellViewObjects) {
viewObject in ArchiveCellView( viewObject: viewObject, targetKeyword: targetKeyword, targetCategory: targetCategory, tapIsStoredButtonAction: { isStored in 　// 👉 Favoriteボタン（ハート型ボタン要素）タップ時処理 } ) .onAppear { // 👉 次ページに表示する要素取得を試みる viewModel.fetchNextPage() } } } ※この処理ではGeometryReaderを利用しなくとも実現可能 `fetchNextPage()`内でindex値等を利用し「一番下のデータが表示された」事を検知する。そして条件合致時にはAPIから次ページ要素一覧を取得し末尾から追加する。

GeometryReaderを利用した表現における過去事例 DroidKaigi2023/2024でContributionを実践した際にも応用した表現をしました 1. Androidアプリである様な近しい表現をするためのアプローチ： 2023年: CoodinatorLayout + TabLayout を組み合わせた様な形 2024年:
GeometryReaderからの値を位置合わせで利用する 2. 特徴的なAnimation表現を位置計算で実現する：

スクロールに連動した日付選択タブの動きを作る(1) デバイス幅等の固有値を利用した位置計算時には回転時の考慮に注意する ① iPad (Portrait & Landscape)： ② iPhone (Portrait
& Landscape)： calculateButtonWidth(deviceWidth: geometry.size.width ) GeometryReaderを利用してButton要素幅を計算する部分回転に伴い値が変化する

スクロールに連動した日付選択タブの動きを作る(2) Android側での実装をまずは調査しタブ部分がどの様な構造かを読み解いてみる SwiftUI側では類似要素は提供されていませんが、擬似的な背景の動きはAnimationで実現できそうでした。 1. TimetableTabRow： 2. TimetableTab：内部ではTabRowを利用した実装 Android側 (Jetpack
Compose) での実装ポイント内部ではTabを利用した実装基本的な実装はTabRow+Tabの組み合わせで実現するこれを踏まえてiOS側でどう実現するか？ 3. TimetableSheetContentScrollState： 🍎 iOS側の構造はButtonを利用していた形でした＋現在時点でのScroll変化量を保持しているState

スクロールに連動した日付選択タブの動きを作る(3) Animationを伴う背景部分とButton配置部分を分離してGeometryReaderを利用 3つ横並びのButton要素に定義したModifier： .background(alignment: .center) { GeometryReader { geometry in
Capsule() .fill(AssetColors.Primary.primary.swiftUIColor) .frame( width: calculateButtonWidth(deviceWidth: geometry.size.width), height: calculateButtonHeight() ) .offset(x: calculateDynamicTabHorizontalOffset(deviceWidth: geometry.size.width), y: 10) .animation(.easeInOut(duration: 0.16), value: selectedDay) } } private func calculateDynamicTabHorizontalOffset(deviceWidth: CGFloat) -> CGFloat { let buttonAreaWidth = calculateButtonWidth(deviceWidth: deviceWidth) // Get the index value corresponding to `selectedDay` and use it for calculation let indexBySelectedDay = getIndexBySelectedDay() return buttonAreaLeadingMargin + (betweenButtonMargin + buttonAreaWidth) * CGFloat(indexBySelectedDay) } private func calculateButtonWidth(deviceWidth: CGFloat) -> CGFloat { // Calculate button width considering related margins let excludeTotalMargin = calculateExcludeTotalMargin() return (deviceWidth - excludeTotalMargin) / CGFloat(buttonsCount) } この様に分離して考えています 14 15 16 Day1 Day2 Day3 Slide Animation 本体背景 ① X軸方向のOffset値をGeometryReaderより算出 ② ボタン背景の幅をGeometryReaderより算出

スクロールに連動した日付選択タブの動きを作る(4) 配置要素の間隔等も考慮した位置関係を算出する際は見通しが良い状態にする特にMargin値・Button要素配置数・Index値等の計算に活用するものを整理する： private func calculateDynamicTabHorizontalOffset(deviceWidth: CGFloat) -> CGFloat {
let buttonAreaWidth = calculateButtonWidth(deviceWidth: deviceWidth) // Get the index value corresponding to `selectedDay` and use it for calculation let indexBySelectedDay = getIndexBySelectedDay() return buttonAreaLeadingMargin + (betweenButtonMargin + buttonAreaWidth) * CGFloat(indexBySelectedDay) } private func getIndexBySelectedDay() -> Int { Int(selectedDay.ordinal) } private func calculateButtonWidth(deviceWidth: CGFloat) -> CGFloat { // Calculate button width considering related margins let excludeTotalMargin = calculateExcludeTotalMargin() return (deviceWidth - excludeTotalMargin) / CGFloat(buttonsCount) } private func calculateExcludeTotalMargin() -> CGFloat { let totalBetweenButtonMargin = betweenButtonMargin * CGFloat(buttonsCount - 1) return buttonAreaLeadingMargin + buttonTrailingMargin + totalBetweenButtonMargin } // Define margin values to calculate horizontal position // (for capsule rectangle) private let buttonAreaLeadingMargin = 16.0 private let buttonTrailingMargin = 16.0 private let betweenButtonMargin = 8.0 // Define all button count to calculate horizontal position // (for capsule rectangle) private var buttonsCount: Int { Int(DroidKaigi2023Day.values().size) }

スクロールに連動した日付選択タブの動きを作る(5) Android側での実装や動きを参考にしながらiOS側でのUI構造と見比べてみる Scrollの変化量に応じてTab部分の高さと表記が変化する表現： NestedScrollに関する公式ドキュメント https://techblog.yahoo.co.jp/android/androidcoordinatorlayout/ AndroidのCoordinatorLayoutを使いこなして、モダンなスクロールを実装しよう https://qiita.com/iwata-n/items/e7c5e8db0f9fbb8c288b Jetpack composeでCoordinatorLayoutを実現する相当するComponentが存在しない
似た動きを実現するには…🧐

スクロールに連動した日付選択タブの動きを作る(6) Android側のView構造を整理した上でiOS側で実現可能な手段を探す TimetableScreen.kt TimetableHeader.kt TimetableSheet.kt nestedScrollを利用して変化量を反映する ScrollViewで同様の処理は可能か？ 🍎 Offset値取得＋Animationの組合せ Header位置を固定
画面のおおもとの部分 Scroll変化量に合わせた処理

スクロールに連動した日付選択タブの動きを作る(7) Scroll変化量を取得する必要があるのでScrollViewを拡張するアプローチ GeometryReader & PreferenceKey の組み合わせ： public struct ScrollViewWithVerticalOffset<Content: View>:
View { let onOffsetChange: (CGFloat) -> Void let content: () -> Content public init( onOffsetChange: @escaping (CGFloat) -> Void, @ViewBuilder content: @escaping () -> Content ) { self.onOffsetChange = onOffsetChange self.content = content } // ポイント: ScrollView(.vertical) 内部でGeometryReaderを利用する // 👉 Scroll変化量を取得できる様な形にしている } // ① body部分 public var body: some View { ScrollView(.vertical) { offsetReader content() .padding(.top, 0) } .coordinateSpace(name: "frameLayer") .onPreferenceChange(OffsetPreferenceKey.self, perform: onOffsetChange) } // ② Offset値読み取り処理部分 private var offsetReader: some View { GeometryReader { proxy in Color.clear .preference( key: OffsetPreferenceKey.self, value: proxy.frame(in: .named("frameLayer")).minY ) 　　} .frame(height: 0) } } private struct OffsetPreferenceKey: PreferenceKey { static var defaultValue: CGFloat = .zero static func reduce(value: inout CGFloat, nextValue: () -> CGFloat) {} }

スクロールに連動した日付選択タブの動きを作る(8) 画面全体構造における基本方針は「ZStack & ScrollView & LazyVStack」の構成全体を構成するTimetableView.swiftにおけるScrollViewのOffset値と関連するAnimation処理の抜粋： ZStack(alignment: .topLeading) {
ZStack(alignment: .top) { // ※ …（画面上部に固定表示される要素を記述）… } ScrollViewWithVerticalOffset( onOffsetChange: { offset in shouldCollapse = offset < verticalOffsetThreshold }, content: { Spacer().frame(height: 130) LazyVStack(spacing: 0, pinnedViews: .sectionHeaders) { Section( header: TimetableDayHeader( selectedDay: viewModel.state.selectedDay, shouldCollapse: shouldCollapse, onSelect: { [weak viewModel] in viewModel?.selectDay(day: $0) } ) .frame(height: shouldCollapse ? 53 : 82) .animation(.easeInOut(duration: 0.08), value: shouldCollapse) ) { // ※ …（一覧表示要素を記述）… } } // Determines whether or not to collapse. private let verticalOffsetThreshold = -142.0 // When offset value is exceed the threshold, TimetableDayHeader collapse with animation. @State private var shouldCollapse = false TimetableHeader.swiftの動き 15 16 Day2 Day3 14 Day1 Day2 Day3 Day1 Collapse or Expand ① 取得したOffset値がしきい値を超えたかどうかを見る ② shouldCollapse値の変化でAnimation発火

スクロールに連動した日付選択タブの動きを作る(9) Header要素内部の表示についてもOffset値を基準として表示内容を変更する .background(alignment: .center) { GeometryReader { geometry in Capsule()
.fill(AssetColors.Primary.primary.swiftUIColor) .frame( width: calculateButtonWidth(deviceWidth: geometry.size.width), height: calculateButtonHeight() ) .offset(x: calculateDynamicTabHorizontalOffset(deviceWidth: geometry.size.width), y: 10) .animation(.easeInOut(duration: 0.16), value: selectedDay) } } TimetableDayHeader( selectedDay: viewModel.state.selectedDay, shouldCollapse: shouldCollapse, onSelect: { [weak viewModel] in viewModel?.selectDay(day: $0) } ) Button { onSelect(day) } label: { VStack(spacing: 0) { Text(day.name) .textStyle(TypographyTokens.labelSmall) if !shouldCollapse { Text("\(day.dayOfMonth)") .textStyle(TypographyTokens.headlineSmall) .frame(height: 32) } } .padding(shouldCollapse ? 6 : 4) .frame(maxWidth: .infinity) .foregroundStyle( // ※selectedDayに応じて背景色を変化 ) } Button背景Modifier Button要素本体変数: shouldCollapseを元に高さを調節

お気に入り追加時のハートマークAnimation対応(1) Androidで実現する動きが綺麗でしたので、SwiftUIでもできるか試してみた既存のView構造でどう構築するか？を考える：直線的な動きならば強引にできるかも: 1. ScrollViewを基準とした位置取得 2. Animation終端位置をGeometryReaderで計算する 👉 画面を基準とした位置はGeometryReaderから算出
Animation概要 👉 DragGestureの処理で代用できないか？を考えてみる ① Button要素では現在の位置が取得できなかった課題となった部分 ❤ ❤ 理想の動き現実の動き ❤ ❤ 弧を描く直線的 👉 お気に入りボタンで追加処理時に位置情報を渡す ② お気に入りに追加した時の考慮ポイント 👉 おおもとの画面をZStackにしてAnimation用View要素と分離する

お気に入り追加時のハートマークAnimation対応(2) タイムテーブル表示要素からタップされた位置を取得するための処理抜粋 // [NOTE] In order to calculate the value
from GeometryReader, it is supported by assigning DragGesture to the Image element instead of Button. HStack { GeometryReader { geometry in // MEMO: Since the coordinate values are based on the inside of the View, ".local" is specified. let localGeometry = geometry.frame(in: .local) Image(isFavorite ? .icFavoriteFill : .icFavoriteOutline) .resizable() .renderingMode(.template) .foregroundColor( isFavorite ? AssetColors.Primary.primaryFixed.swiftUIColor : AssetColors.Surface.onSurfaceVariant.swiftUIColor ) .frame(width: 24, height: 24) .gesture(DragGesture(minimumDistance: 0, coordinateSpace: .global).onEnded { dragGesture in // MEMO: The offset value in the Y-axis direction is subtracted for adjustment (decided by device orientation). let adjustedLocationPoint = CGPoint(x: dragGesture.location.x, y: dragGesture.location.y - calculateTopMarginByDevideOrietation()) onTapFavorite(timetableItem, adjustedLocationPoint) }) // MEMO: To adjust horizontal position, I'm subtracting half the size of Image (-12). .position(x: localGeometry.maxX - 12, y: localGeometry.midY) } } let onTapFavorite: (TimetableItem, CGPoint?) -> Void タップ時には該当するTimetableItemと一緒に.gestureで取得できたGeometryReaderの値を一覧表示するView要素へ送る。回転の考慮も必要 👉 基準はこのView内部 👉 .positionではView内部を基準としたX軸＆Y軸方向の位置を指定する 👉 最終的に送られるのは画面全体を基準とした位置の値 - DragGestureを利用してボタンタップの様に見せている - Drag終了時位置をClosureで送信（coordinateSpace: .global）

ZStack { ScrollView { LazyVStack(spacing: 0) { ForEach(store.timetableItems, id: \.self)
{ item in TimeGroupMiniList(contents: item, onItemTap: { item in store.send(.view(.timetableItemTapped(item))) }, onFavoriteTap: { timetableItemWithFavorite, adjustedLocationPoint in store.send(.view(.favoriteTapped(timetableItemWithFavorite))) // MEMO: When "isFavorited" flag is false, this view executes animation. if timetableItemWithFavorite.isFavorited == false { toggleFavorite(timetableItem: timetableItemWithFavorite.timetableItem, adjustedLocationPoint: adjustedLocationPoint) } }) } }.scrollContentBackground(.hidden) .onAppear { store.send(.view(.onAppear)) }.background(AssetColors.Surface.surface.swiftUIColor) bottomTabBarPadding } // MEMO: Stack the Image elements that will be animated using ZStack. makeHeartAnimationView() } お気に入り追加時のハートマークAnimation対応(3) タイムテーブル一覧画面の構造は一覧表示と動きを作るための要素を分割する 👉 タイムテーブル一覧表示はScrollView + LazyVStack TimetableItemと一緒に.gestureで取得できたGeometryReaderの値 @ViewBuilder private func makeHeartAnimationView() -> some View { GeometryReader { geometry in if targetTimetableItemId != nil { Image(systemName: "heart.fill") .foregroundColor( AssetColors.Primary.primaryFixed.swiftUIColor ) .frame(width: 24, height: 24) .position(animationPosition(geometry: geometry)) .opacity(1 - animationProgress) .zIndex(99) } } } ハートマークが画面上を動く様に見せる 👉 ハートマークImage要素を単体で重ねて表示する 👉 @Stateの値変化でAnimationを実行 Animationを実行するために@Stateを更新

お気に入り追加時のハートマークAnimation対応(4) @ViewBuilder private func makeHeartAnimationView() -> some View { GeometryReader
{ geometry in if targetTimetableItemId != nil { Image(systemName: "heart.fill") .foregroundColor( AssetColors.Primary.primaryFixed.swiftUIColor ) .frame(width: 24, height: 24) .position(animationPosition(geometry: geometry)) .opacity(1 - animationProgress) .zIndex(99) } } } // MEMO: A variable that stores the value of Animation variation. (Only 0 or 1) @State private var animationProgress: CGFloat = 0 // MEMO: Select target targetTimetableItemId & targetLocationPoint (for Animation). @State private var targetTimetableItemId: TimetableItemId? @State private var targetLocationPoint: CGPoint? private func animationPosition(geometry: GeometryProxy) -> CGPoint { // MEMO: Get the value calculated from both the default and .global GeometryReader. let globalGeometrySize = geometry.frame(in: .global).size let defaultGeometrySize = geometry.size // MEMO: Calculate the offset value in the Y-axis direction using GeometryReader. let startPositionY = targetLocationPoint?.y ?? 0 let endPositionY = defaultGeometrySize.height - 25 let targetY = startPositionY + (endPositionY - startPositionY) * animationProgress // MEMO: Calculate the offset value in the X-axis direction using GeometryReader. let adjustedPositionX = animationProgress * (globalGeometrySize.width / 2 - globalGeometrySize.width + 50) let targetX = defaultGeometrySize.width - 50 + adjustedPositionX return CGPoint(x: targetX, y: targetY) } 👉 toggleFavoriteを実行すると@Stateが更新される - animationProgressの値はアルファ値と計算で利用する - タイムテーブルID & タップ位置もnullableの変数で保持する - Animation終了位置算出や要素表示可否の決定をする 👉 GeometryReaderと@Stateで位置を算出する ②位置＆アルファ更新 ①表示可否 private func toggleFavorite(timetableItem: TimetableItem, adjustedLocationPoint: CGPoint?) { targetLocationPoint = adjustedLocationPoint targetTimetableItemId = timetableItem.id // MEMO: Execute animation. if targetTimetableItemId != nil { withAnimation(.easeOut(duration: 1)) { animationProgress = 1 } Task { try await Task.sleep(nanoseconds: 1_000_000_000) targetTimetableItemId = nil targetLocationPoint = nil animationProgress = 0 } } }

タブ表示要素のView構造とScroll連動処理(1) 考えやすくするためにUIKit利用時と同様に大きく2つの要素に分けてみる Body要素内はタブ要素とコンテンツ要素の様な粒度に分割してみる：ページング処理に合わせて下線が移動タブ要素を押下時に該当コンテンツを表示 // MARK: -
Body var body: some View { NavigationStack { VStack(spacing: 0.0) { // 1. Slider式のTab要素を並べたView要素 PremiumPosterTabView() // 2. Slider式のContents要素を並べたView要素 PremiumPosterContentsView() } // Navigation表示に関する設定 .navigationTitle(“Premium Poster") .navigationBarTitleDisplayMode(.inline) } } UIKitの場合はDelegateを応用してView間の処理を接続したが、SwiftUI利用時はどうするか？別々に定義したView要素間の処理を最終的には接続する。 👉 `@State`での状態変化を応用 View要素の位置変化に特に注目

タブ表示要素のView構造とScroll連動処理(2) `@State`で定義した変数が「何が変化した時に更新されるか？」に注目するそれぞれのView要素内で発生した状態変化を格納する：ページング処理に合わせて下線が移動タブ要素を押下時に該当コンテンツを表示 // MARK: -
`@State` Property // 配置対象のTab要素全てを格納する変数 @State private var tabs: [PosterLineupModel] // 現在選択されているTab要素としての変数 @State private var activeTab: PosterLineupModel.Tab // Tab要素をスクロールした時の状態を格納する変数 @State private var tabViewScrollState: PosterLineupModel.Tab? // メインContents要素をスクロールした時の状態を格納する変数 @State private var mainViewScrollState: PosterLineupModel.Tab? // Drag操作をしている最中の変化量を一時的に格納する変数 @State private var progress: CGFloat // 任意のTab要素タップ時からAnimation動作中に表示する連打防止用矩形エリア表示フラグ @State private var showRectangleToPreventRepeatedHits: Bool 定義した変数がいかなるタイミングで更新され、どの処理のために利用されるか？を整理しながら進めていく。 👉 わかりやすい変数名が良い

タブ表示要素のView構造とScroll連動処理(3) 今回紹介するサンプルでは対象要素のCGRect型を返しその値をView処理で利用 GeometryReaderからOffset値を返す様に調整する： extension View { // MARK: - Function
@ViewBuilder func getRectangleView(completion: @escaping (CGRect) -> ()) -> some View { // .overlay表示用Modifier内の処理でOffset値を取得できる形にする self.overlay { // GeometryReader内部にはColorを定義してScrollView内に配置する要素には極力影響を及ぼさない様にする GeometryReader { proxy in let rectangle = proxy.frame(in: .scrollView(axis: .horizontal)) // 👉 OffsetPreferenceKey定義とGeometryProxyから取得できる値を紐づける事でこの値変化を監視対象に設定する Color.clear .preference(key: OffsetPreferenceKey.self, value: rectangle) .onPreferenceChange(OffsetPreferenceKey.self, perform: completion) } } } } // MEMO: 配置したTab要素に対して座標位置を取得するためのExtension定義 // GeometryReaderを利用して、親Viewの座標情報等が利用できる点を活用する // 参考: https://blog.personal-factory.com/2019/12/08/how-to-know-coorginate-space-by-geometryreader/ struct OffsetPreferenceKey: PreferenceKey { static var defaultValue: CGRect = .zero static func reduce(value: inout CGRect, nextValue: () -> CGRect) { value = nextValue() } } 透明な背景要素をOffset値の監視対象とする点がポイント .getRectangleView { rect in // … (この値を活用した処理を実行する) … } Tab要素サイズや移動量の割合算出で利用（用途に合わせてGeometryReaderの基準を変える）

タブ表示要素のView構造とScroll連動処理(4) 基本構造はScrollViewから取得した変化量を表示更新に必要な`@State`へ適用 @ViewBuilder private func PremiumPosterContentsView() -> some View {
// GeometryReaderを利用してContents表示要素の移動変化量を取得する GeometryReader { proxy in let targetSize = proxy.size // GeometryReaderから取得した値とScrollViewを連動させる方針を取る ScrollView(.horizontal, showsIndicators: false) { // 横一列にタブ要素分だけ対応するコンテンツ要素を並べる LazyHStack(spacing: 0.0) { ForEach(tabs) { tab in // TODO: コンテンツ要素用のView要素を作成する } } .scrollTargetLayout() // 独自に定義した「.getRectangleView」を利用してX軸方向のOffset値を取得する .getRectangleView { rect in // 変化量の割合を格納する変数「progress」へDrag操作最中の変化量を格納する progress = -rect.minX / targetSize.width } } // … ScrollView用のModifier定義 … } } Tab要素の文字列下部に配置した「動く下線表示」のX軸方向のOffset値になる点がポイント。 .scrollPosition(id: $mainViewScrollState) .scrollTargetBehavior(.paging) // コンテンツ表示要素におけるX軸方向のOffset値を格納する変数 // 「mainViewScrollState」の変化時に実行される処理 .onChange(of: mainViewScrollState) { oldValue, newValue in if let newValue { // .snappyで弱いバネ運動の様な感じを演出する withAnimation(.snappy) { activeTab = newValue tabViewScrollState = newValue } } } 👉 Tab要素のスクロール位置＆現在選択中Tab要素を更新表示コンテンツがメインとなる操作変数: progresの値はタブ要素関連の位置調整のために利用する。

タブ表示要素のView構造とScroll連動処理(5) iOS17から追加されたScroll関連Modifierとの連携処理に注目する実装ポイントをまとめる： ① GeometryReaderから取得した値とScrollViewを連動させる方針を取る 👉 ScrollView & LazyHStackの組み合わせなので、X軸方向のOffset値に注目する ②
.scrollTargetLayout() ＆ .scrollPosition(id: $mainViewScrollState) に関する解説 👉 scrollTargetLayout(): ScrollView内で特定の位置までスクロールするために必要なModifier 👉 scrollPosition(id: $mainViewScrollState): コンテンツ表示要素におけるX軸方向のOffset値を格納する変数「mainViewScrollState」の位置まで移動するために必要なModifier 👉 scrollTargetBehavior(.paging): 配置したScrollViewどのように機能するかを決定するためのModifier（今回は.pagingを指定してページ切替の形） https://developer.apple.com/documentation/swiftui/view/scrolltargetlayout(isenabled:) https://developer.apple.com/documentation/swiftui/view/scrollposition(id:anchor:) https://developer.apple.com/documentation/swiftui/scrolltargetbehavior

タブ表示要素のView構造とScroll連動処理(6) 様々な要素がかなり複雑に絡み合う構造をとるView要素なので整理がとても大事 @ViewBuilder private func PremiumPosterTabView() -> some View {
// MEMO: ZStackを利用して、Tab全体に必要な要素を配置する。 ZStack(alignment: .leading) { // ① Tab要素配置用のScrollView // ② Tab表示エリアに合わせる形で連打防止用にRectangleを重ねる } .scrollPosition(id: $tabViewScrollState, anchor: .center) // Tab要素を並べたScrollViewの上に更に要素を重ねる形を取る .overlay(alignment: .bottom) { // ③ コンテンツ部分のスクロール処理と連動する } .safeAreaPadding(.horizontal, 16.0) } // 👉 .clearを指定すると連続タップ時にTab要素が意図しない位置で停止する // 👉 任意の色を定めてopacityを0未満の小さな値にして対処 if showRectangleToPreventRepeatedHits { Rectangle().fill(.red.opacity(0.001)) .frame(height: 36.0).padding(.horizontal, -16.0) } タブ表示部分を連打した際においても正しく動作する様に②の様な考慮を加える。 ForEachで横1列のButton要素に並べて表示する。 // 0.00〜0.35秒間は連打防止用の矩形要素を表示した状態にする Task { showRectangleToPreventRepeatedHits = true try await Task.sleep(for: .milliseconds(350)) showRectangleToPreventRepeatedHits = false } // .snappyで弱いバネ運動の様な感じを演出する withAnimation(.snappy) { activeTab = tab.id // 👉 Tab要素のスクロール位置 tabViewScrollState = tab.id // 👉 現在選択されているTab要素 mainViewScrollState = tab.id // 👉 現在選択されているContents要素を更新する } ForEach($tabs) { $tab in … } .getRectangleView { rect in … } .scrollTargetLayout() 動く下線要素をこちらに配置する。

タブ表示要素のView構造とScroll連動処理(7) 線形補間の計算式の考え方を応用する事でより自然な表現にするための工夫この処理があると何が嬉しいのか？： // Tab要素のindex値をArrayに変換する let inputRange = tabs.indices.compactMap {
CGFloat($0) } // Tab要素の文字列幅をArrayに変換する let ouputRange = tabs.compactMap { $0.size.width } // Tab要素を並べた時のX軸方向のOffset値の一覧をArrayに変換する let outputPositionRange = tabs.compactMap { $0.minX } // 動く下線要素の幅が変化して、次のタブ要素へ進む（前のタブ要素へ戻る）際の幅を算出する let indicatorWidth = progress.calculateInterpolate( inputInterpolateRange: inputRange, outputInterpolateRange: ouputRange ) // 動く下線要素の幅が変化して、次のタブ要素へ進む（前のタブ要素へ戻る）際のX軸方向のOffset値を算出する let indicatorPosition = progress.calculateInterpolate( inputInterpolateRange: inputRange, outputInterpolateRange: outputPositionRange ) 線形補間の計算式と近似誤差: https://manabitimes.jp/math/1422 タブ要素に表示される名前はない様に応じて文字数が変化するので、切り替わるタイミングで下線の長さを自然に変化させる。変化量に応じて表示文字列＆下線長さが変化する形。変数: progresの値が計算のベースになる点がポイント

タブ表示要素のView構造とScroll連動処理(8) // 座標点の配列を元にした // 線形補間の計算を利用した座標位置 func calculateInterpolate( 　　inputInterpolateRange: [CGFloat], outputInterpolateRange:
[CGFloat] ) -> CGFloat let positionX = self let length = inputInterpolateRange.count - 1 // 最初に与えられた値が最初の入力値より小さい場合は、最初の出力値を返す if positionX <= inputInterpolateRange[0] { return outputInterpolateRange[0] } // 与えられた点の間を近似する処理を実行する // 👉 この値を利用する事でDrag移動時に伴って移動するオブジェクトに対して滑らかな動きを付与する事が可能 for index in 1...length { // 2点間(x1, y1) & (x2, y2)の座標を算出する let x1 = inputInterpolateRange[index - 1] let x2 = inputInterpolateRange[index] let y1 = outputInterpolateRange[index - 1] let y2 = outputInterpolateRange[index] // 算出した座標値を元に線形補間の計算を実行して変化量を算出する // 👉 線形補間の計算式: y1 + ((y2 - y1) / (x2 - x1)) * (positionX - x1) if positionX <= inputInterpolateRange[index] { let positionY = y1 + ((y2 - y1) / (x2 - x1)) * (positionX - x1) return positionY } } // 線形補間の計算で算出できなかった場合は、出力値の最後の値を返す様にする return outputInterpolateRange[length] // 動く下線要素の幅が変化して、次のタブ要素へ進む（前のタブ要素へ戻る）際の幅を算出する let indicatorWidth = progress.calculateInterpolate( inputInterpolateRange: inputRange, outputInterpolateRange: ouputRange ) // 動く下線要素の幅が変化して、次のタブ要素へ進む（前のタブ要素へ戻る）際のX軸方向のOffset値を算出する let indicatorPosition = progress.calculateInterpolate( inputInterpolateRange: inputRange, outputInterpolateRange: outputPositionRange ) 補間の公式の考え方をUI実装に応用する下線部分の表現を綺麗にするための工夫となる点。

サムネイル画像ギャラリーの様な形を考えてみる(1) 画像要素が横一列に並んで自動で左方向へ進んでいく＆Drag処理ができる仕様指でのScroll & Timer処理の2つを許可 αϜωΠϧը૾ΪϟϥϦʔ GeometryReaderで実装できる？最新のModifierを活用する？ ᶃ ᶄ ᶅ
ᶆ ᶉ ᶊ ᶃ ᶄ αϜωΠϧը૾ΪϟϥϦʔ Drag処理時でも自然な繋ぎ目になる SwiftUIで実装する際に起こり得る課題を整理するポイントになるのはしきい値を超過した際の位置変更処理をどうするかの部分 ※イメージ図解を紐解くとこの様な形になる予め表示想定の3倍の表示要素を確保する ՄࢹྖҬ ՄࢹྖҬ ՄࢹྖҬ 後はこの処理を繰り返す形 Carousel要素全体の長さの2倍を超過した場合は位置調整

サムネイル画像ギャラリーの様な形を考えてみる(2) 自動でのCarousel処理は短い時間のTimerで表示位置を更新する事で実現する指でのScroll & Timer処理の2つを許可 αϜωΠϧը૾ΪϟϥϦʔ ᶃ ᶄ ᶅ ᶆ
ᶉ ᶊ ᶃ ᶄ αϜωΠϧը૾ΪϟϥϦʔ Drag処理時でも自然な繋ぎ目になる画面全体に配置するView要素のイメージ VStack { InfiniteCarouselView(imageNames: imageNames, velocity: 0.25) } InfiniteCarouselViewで利用するState値の定義 InfiniteCarouselViewを準備してCarousel要素を分離する（velocityは動かす速度） Timerとわずかな移動距離が変更された時にViewを再度レンダリングする様な形 @State private var scrollPosition = ScrollPosition() @State private var timer = Timer .publish(every: 0.01, on: .main, in: .common) .autoconnect() @State private var x: CGFloat Scroll位置とX軸方向のOffset値 Timer処理

サムネイル画像ギャラリーの様な形を考えてみる(3) 計算処理におけるポイントになるのは「1セット分の要素全体の長さ」指でのScroll & Timer処理の2つを許可 αϜωΠϧը૾ΪϟϥϦʔ ᶃ ᶄ ᶅ ᶆ
ᶉ ᶊ ᶃ ᶄ αϜωΠϧը૾ΪϟϥϦʔ Drag処理時でも自然な繋ぎ目になる初期化処理時とBody要素本体の構造 Initialize処理時にItem要素＆隙間を合わせた全体の長さを計算して保持しておく ScrollView(.horizontal, showsIndicators: false) { HStack(spacing: itemSpacing) { ForEach(items) { item in CarouselCard(imageName: item.imageName) .id(item.id) } } .safeAreaPadding(.horizontal) } let length = (CarouselCard.itemSize.width + itemSpacing) * CGFloat(imageNames.count) self.x = length self.carouselLength = length ScrollViewに配置するのは表示する要素の個数別途変数に保持しておく

サムネイル画像ギャラリーの様な形を考えてみる(4) Timer処理で自動で位置を少しずつ動かしていく部分はこの様な形となる指でのScroll & Timer処理の2つを許可 αϜωΠϧը૾ΪϟϥϦʔ ᶃ ᶄ ᶅ ᶆ
ᶉ ᶊ ᶃ ᶄ αϜωΠϧը૾ΪϟϥϦʔ Drag処理時でも自然な繋ぎ目になる付与するModifierの全容(1) 各種Modifierを利用した処理を組み合わせて条件を満たす様な自動スクロールを作成 .scrollClipDisabled() .scrollPosition($scrollPosition) .onReceive(timer) { _ in if x >= carouselLength * 2 || x <= 0 { x = carouselLength } else { x += velocity } } .onChange(of: x) { scrollPosition.scrollTo(x: x) } ①.onReceive 👉 ②.onChange 👉 ③.scrollPositionの順番で処理が実行 Body要素に付与するModifierの抜粋 Timerが更新されたらverocityの分だけ @State private var xへ加算する。しきい値を超過した時は位置を戻す。 @State private var scrollPosition 値が更新されたらScrollPositionを動かす。

サムネイル画像ギャラリーの様な形を考えてみる(5) iOS18から利用できるModifierを利用してTimer制御やDrag処理を実行する指でのScroll & Timer処理の2つを許可 αϜωΠϧը૾ΪϟϥϦʔ ᶃ ᶄ ᶅ ᶆ
ᶉ ᶊ ᶃ ᶄ αϜωΠϧը૾ΪϟϥϦʔ Drag処理時でも自然な繋ぎ目になる .onScrollPhaseChange { oldPhase, newPhase in switch (oldPhase, newPhase) { case (.idle, .idle): break case (_, .interacting): timer.upstream.connect().cancel() case (_, .idle): timer = Timer.publish(every: 0.01, on: .main, in: .common).autoconnect() default: break } } .onScrollGeometryChange(for: Double.self) { scrollGeometry in scrollGeometry.contentOffset.x } action: { oldValue, newValue in x = newValue } 付与するModifierの全容(2) 1. ユーザーが指でスクロールし始めた際にタイマーを停止 👉 timer.upstream.connect().cancel() 2. スクロールが止まった（idle）タイミングで再びタイマーを作成し、自動スクロールを再開ユーザーのドラッグ操作中のスクロール位置もX軸方向のOffset値に反映

補足1. ScrollViewReaderを併用した表現事例 $VSSZ 1J[[B 4BOEXJUDI 🍛 ΧϨʔಛू … List要素等でSection毎に一覧表示 $VSSZ
1J[[B 4BOEXJUDI 🍕 ϐοπΝಛू SectionHeader要素次のSectionへ到達スクロール実行 🔖 ScrollViewReaderを活用した処理と合わせる Contents要素のスクロール時にTab要素を移動 & Tab要素押下時は特定要素Section要素まで移動参考資料: https://www.youtube.com/watch?v=XUeophZ1iTo

補足2. GeometryReaderを上手に活用して応用した事例 SwiftUIで作成するTinder風のCard切り替え操作をするサンプル https://github.com/fumiyasac/TinderCartExampleSwiftUI Tinderの様にスワイプ操作を利用してマッチング相手を選出する形のUIに類似した構造を SwiftUIのDragGestureを利用して組み立てたサンプルになります。

補足3. GeometryReaderで取得した値と表現の設計特に既存のUIに調整対応を加える部分については要点をまとめる様にしました 2023年のContribution当時の設計資料： https://twitter.com/fumiyasac/status/1695835586719044047 https://twitter.com/fumiyasac/status/1693501752811917546 2024年のiOSDCのパンフレット原稿資料： https://github.com/fumiyasac/iosdc2024_pamphlet_manuscript_vol2

まとめ iOS17/18ではGeometryReader（＋新Modifier）で複雑UIにも十分対応できる GeometryReaderの有効活用によって様々な表現を実現可能な一方で新バージョンで提供されたAPIで依存を減らす事も大事 1. GeometryReaderは「値取り専用」で割り切る：どの座標空間で何の値（minY/sizeなど）が欲しいかを先に決め、最小限だけ取得する。得た値はStateやViewModelに閉じ込め、描画やレイアウト調整は別View/Modifierに委譲。副作用の伝播を最小化し、スクロールに強い構成にする。 2. ScrollViewは新Modifierを主役に位置を宣言的に扱う： scrollPosition＋scrollTargetLayoutで位置管理、scrollTargetBehavior(.paging)で自然なページングを宣言。iOS18の
onScrollPhaseChange／onScrollGeometryChangeでドラッグとオフセットを拾い、命令的制御を抑えて競合を避ける。 3. SwiftUIの分割で複雑さを「値→状態→見た目」に整理： ZStack（固定物）＋ScrollView（Lazy系）＋表示コンポーネントに分割。取得値はまず状態へ落とし、ヘッダー縮小やパララックスは補間で滑らかに表現して、保守性とパフォーマンスを両立。

Thank you for listening !

SwiftUIのGeometryReaderとScrollViewを基礎から応用まで学び直す：...

SwiftUIのGeometryReaderとScrollViewを基礎から応用まで学び直す：設計と活用事例

Fumiya Sakai

More Decks by Fumiya Sakai

Other Decks in Technology

Featured

Transcript