Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Apple純正カレンダーっぽさをSwiftUIで分解する

Sponsored · Your Podcast. Everywhere. Effortlessly. Share. Educate. Inspire. Entertain. You do you. We'll handle the rest. →

 Apple純正カレンダーっぽさをSwiftUIで分解する

11/21に開催された「Saitama.swift #1」の登壇資料になります。

Apple純正カレンダーのように連続スクロールする月表示を、SwiftUIで分解します。nilで揃える月グリッド、重ねて表す日付セル、名前付き座標空間とPreferenceKeyによる表示中の月の検出、月単位のStateMachineまで、実際のコードとともに読み解きます。

Fumiya Sakai

November 16, 2026

Transcript

21 slides
  1. 自己紹介 発表者: iOS / Android / Flutter / Backend アカウント:

    ・Twitter: https://twitter.com/fumiyasac ・Fumiya Sakai ・Facebook: https://www.facebook.com/fumiya.sakai.37 ・Mobile Application Engineer ・Born on September 21, 1984 ・Github: https://github.com/fumiyasac ・Qiita: https://qiita.com/fumiyasac@github これまでの歩み: 2008 ~ 2010 2012 ~ 2016 2017 ~ Now Web Designer Web Engineer App Engineer
  2. 技術書同人誌博覧会スタッフ&デザイン協力もしてます (告知)第15回技書博は2027/05/15に大田区産業プラザPiOにて開催予定! 🍀 #12 一般参加募集チラシ 🍀 #13 次回案内チラシ 🍀 #14

    サークル参加募集 🍀 #15 次回案内チラシ Conpassから一般参加者を募集していますのでぜひ参加登録をお願いします🙇 https://gishohaku.connpass.com/event/402867/
  3. カレンダーを4つの表示責務に分割して考えてみる 曜日ヘッダーはScrollViewの外で月見出し7列グリッドは月ごとに配置する 1. CalendarMonthScreen: 2. CalendarMonthView: NavigationStack・年表示 月見出し 曜日ヘッダー・連続スクロール 1年だけ年サフィックス

    日付選択と画面遷移 月の境界線 4. CalendarDayCellView: 3. CalendarMonthGridView: 今日・選択リング・曜日色 7列のLazyVGrid 掲載と調理記録のマーカー Date?のnilは空白セル 読み上げ用ラベル タップを親クロージャへ通知
  4. 日付配列は先頭と末尾をnilで揃える 2026年10月の計算例→日曜始まりなので木曜日の1日までに空白が4つ入る 日 月 火 水 木 金 土 nil

    nil nil nil 1 2 3 1. 先頭の余白 = 5 - 1 = 4 weekday(木曜)= 5 4 5 6 7 8 9 10 firstWeekday(日曜)= 1 11 12 13 14 15 16 17 2. 4 + 31 = 35セル 18 19 20 21 22 23 24 25 26 27 28 29 30 31 35は7の倍数。末尾余白は0。 月に応じて4〜6行になる。 前提: firstWeekday = 1 に固定。週の開始曜日を変える時は差分式も再検討する。
  5. 日付セルはbackgroundとoverlayの重ね合わせで表現 実際にはCalendarDayViewData.swiftのBoolがtrueのものだけ描画される仕組み ① .background { Circle().fill(accent) } 今日の赤丸(文字は白抜き) ② .overlay

    { Circle().strokeBorder(…) } 選択リング(今日の上では白で描く) ③ .overlay(alignment: .topTrailing) 30 レシピ掲載マーカー(fork.knife) ④ .overlay(alignment: .topLeading) 調理記録マーカー(checkmark.seal.fill) ⑤ Color.clear.frame(height: 8) マーカー用の余白で日付の縦位置を揃える ⑥ .accessibilityElement(children: .ignore) セル全体を1要素として読み上げる
  6. 縦に途切れず続く月表示と今見えている月の検出 この体験は基準月からのオフセットをLazyVStackに並べることで実現している offset: -1200 ~ -2(未生成) ① CalendarMonthPositionKey 各月の [offset:

    minY] をmergeして親へ offset: -1 offset: 0(今月) ② offset 0: minY <= 1 上端が画面上端を越えている → 候補 ※上端は画面より上 offset: +1 ※上端は画面の中 ③ offset +1: minY > 1 まだ画面上端に届いていない → 対象外 候補のうちminY最大の月を採用 可視範囲 offset: +2 👉 visibleOffset = 0、年表示を更新 ※候補が無いときはminYが最小の月を採用 offset: +3 ~ +1200(未生成) 表示中の月 = 上端が画面上端を越えた月のうち、最も下にある月
  7. PreferenceKey による「子から親」の値の流れ 値は通常「親から子」、位置情報だけPreferenceKeyで「子から親」へ戻す CalendarMonthScreen(親) @State visibleOffset と .navigationTitle(yearText) を持つ .onPreferenceChange

    通常の流れ(親から子) CalendarMonthPositionKey.reduce state と onSelectDate を引数で渡す 各子の [offset: minY] を merge .preference(key:value:) LazyVStack内の各月(子) offset: −1 の月 offset: 0 の月 offset: +1 の月 GeometryReader で minY を送出 GeometryReader で minY を送出 GeometryReader で minY を送出
  8. 月の上端位置から年タイトル用の月を選ぶ 「monthScroll」の座標系で集めたminYを1pxの境界と比較する 採用規則 スクロール領域の上端: y = 0 min <= 1

    の候補から最大値を選ぶ この例では -50 の月を採用 前々月の上端: -430 候補がなければ全体の最小 minY 年タイトルへの反映 visibleOffset が変わったときだけ更新 前月の上端: -50 baseMonth + visibleOffset から年を作る 実際の可視面積を比較する方式ではない 当月の上端: +370
  9. スクロール復元中は月の追跡を一時停止する レイアウトが落ち着くまでscrollToを繰り返す現在の実装上の調整 restore(to:using:) 0 ms 150 ms 300 ms 450

    ms ScrollTo ScrollTo ScrollTo 追跡を有効化 復元を始める条件 初回表示・月タブへの復帰 「今日」ボタンでは offset = 0 へ戻す タブ非表示時も追跡を停止 「今日」ボタンをタップすると本日の月まで戻る機能
  10. 状態と責務に関する所有者を整理してみる 変化の速い見た目の状態ほどView側に置き、確定したデータほど下の層に置く View の @State / @Namespace(見た目の一時状態) 変化が速い UI固有 selectedTab

    path / visibleOffset scrollOffset @Namespace / filter CalendarRootView CalendarMonthScreen RecipeDetailScreen TimelineScreen ViewModel(@MainActor @Observable) CalendarViewModel TimelineViewModel RecipeDetailViewModel 月ごとの読込StateとTask 日付別の一覧State loading / loaded / failed 純粋な値型と関数(Swift Testing で単体検証) CalendarReducer CalendarMonthGrid ViewDataFactory RecipeHeroMetrics SourceID State → 次のState 月 → セル配列 State → セル表示 offset → 描画値 行 → 一意な ID 確定した データ UseCase / Repository(確定したデータの入口)
  11. 非同期処理はViewModelだけ、Reducerは純粋関数のまま MVVM + Reduxに近いArchitectureにして単一方向データフローにしている CalendarMonthScreen Action ViewModel.send beginLoading MonthKey と

    requestID を確定 .onAppear で月ごとに送信 CalendarReducer 新しい State と Effect を返す loadSucceeded / loadFailed effects await CalendarUseCase ViewModel.send その月のレシピと記録を取得 MonthKey と requestID を確定 補足 ReducerはTaskを起動せず、Date()・UUID()も作らない(requestIDはViewModelが採番) 完了ActionはrequestIDがその月の進行中IDと一致したときだけ反映され、更新されたStateでViewが再描画される
  12. 連続する月データは月キーごとに保存する 表示位置の状態とデータ取得状態を分け、別月の完了で他月を上書きしない months[2026-10] months[2026-11] months[2026-12] phase = loaded phase =

    loading phase = loading recipeEntries / mealLogs 直前のデータを保持 別月のTaskは継続 requestID = nil requestID = B requestID = C 成功Actionが来たとき 重複した読込要求 monthKey と requestID を照合 loading / loaded なら Effect を返さない 一致する月のデータ・phaseを更新する onAppear の回数を通信回数にしない 一致しない古い結果は適用しない 画面内キャッシュと永続キャッシュは別

More Decks by Fumiya Sakai

Other Decks in Technology