Share
Embed
Apple純正カレンダーっぽさをSwiftUIで分解する
11/21に開催された「Saitama.swift #1」の登壇資料になります。
Apple純正カレンダーのように連続スクロールする月表示を、SwiftUIで分解します。nilで揃える月グリッド、重ねて表す日付セル、名前付き座標空間とPreferenceKeyによる表示中の月の検出、月単位のStateMachineまで、実際のコードとともに読み解きます。
Fumiya Sakai
November 16, 2026
Transcript
21 slides
-
自己紹介 発表者: 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 -
技術書同人誌博覧会スタッフ&デザイン協力もしてます (告知)第15回技書博は2027/05/15に大田区産業プラザPiOにて開催予定! 🍀 #12 一般参加募集チラシ 🍀 #13 次回案内チラシ 🍀 #14
サークル参加募集 🍀 #15 次回案内チラシ Conpassから一般参加者を募集していますのでぜひ参加登録をお願いします🙇 https://gishohaku.connpass.com/event/402867/ -
カレンダーを4つの表示責務に分割して考えてみる 曜日ヘッダーはScrollViewの外で月見出し7列グリッドは月ごとに配置する 1. CalendarMonthScreen: 2. CalendarMonthView: NavigationStack・年表示 月見出し 曜日ヘッダー・連続スクロール 1年だけ年サフィックス
日付選択と画面遷移 月の境界線 4. CalendarDayCellView: 3. CalendarMonthGridView: 今日・選択リング・曜日色 7列のLazyVGrid 掲載と調理記録のマーカー Date?のnilは空白セル 読み上げ用ラベル タップを親クロージャへ通知 -
日付配列は先頭と末尾を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 に固定。週の開始曜日を変える時は差分式も再検討する。 -
日付セルは4種類の状態を重ねて表す 掲載日と調理日は別の情報で、様々な状態を1つのセル内で表示する 今日: 塗りつぶした赤丸 isToday。日付の文字は白丸へ切り替える。 選択中: 輪郭のリング isSelected。今日と重なった時は白いリング。 30 右上:
レシピの掲載がある hasRecipe。DailyRecipeEntryのdateKey一致。 左上: 調理記録がある hasMealLog。MealLogSummaryのdateKey一致。 掲載レシピとの対応確認には別の情報が必要。 -
日付セルは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要素として読み上げる -
縦に途切れず続く月表示と今見えている月の検出 この体験は基準月からのオフセットを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(未生成) 表示中の月 = 上端が画面上端を越えた月のうち、最も下にある月 -
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 を送出 -
月の上端位置から年タイトル用の月を選ぶ 「monthScroll」の座標系で集めたminYを1pxの境界と比較する 採用規則 スクロール領域の上端: y = 0 min <= 1
の候補から最大値を選ぶ この例では -50 の月を採用 前々月の上端: -430 候補がなければ全体の最小 minY 年タイトルへの反映 visibleOffset が変わったときだけ更新 前月の上端: -50 baseMonth + visibleOffset から年を作る 実際の可視面積を比較する方式ではない 当月の上端: +370 -
スクロール復元中は月の追跡を一時停止する レイアウトが落ち着くまでscrollToを繰り返す現在の実装上の調整 restore(to:using:) 0 ms 150 ms 300 ms 450
ms ScrollTo ScrollTo ScrollTo 追跡を有効化 復元を始める条件 初回表示・月タブへの復帰 「今日」ボタンでは offset = 0 へ戻す タブ非表示時も追跡を停止 「今日」ボタンをタップすると本日の月まで戻る機能 -
状態と責務に関する所有者を整理してみる 変化の速い見た目の状態ほど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(確定したデータの入口) -
非同期処理は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が再描画される -
連続する月データは月キーごとに保存する 表示位置の状態とデータ取得状態を分け、別月の完了で他月を上書きしない 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 の回数を通信回数にしない 一致しない古い結果は適用しない 画面内キャッシュと永続キャッシュは別 -
まとめ 想像以上にAppleの純正カレンダーの構造は美しいけど複雑だった件 1. 複雑なカレンダー機能をSwiftUIで作成する場合の注意点: シンプルなグリッド構造ならUICollectionViewと比較すると実装は容易ではあるが、曜日を活用した日にちの配置計算や表示要 素によっては要素の重なりや必要な計算が多くなるので注意が必要。 2. スクロールを伴うカレンダーの挙動はかなり複雑になりがち: ナビゲーション部分に配置されている「今日」ボタンを押下して現在日が含まれるカレンダーまで配置を変更する処理やスク ロール位置に応じてタイトル部分の該当年が変化する処理等はScrollViewのModifierを利用しても結構難しい。
3. 生成AIでUI実装のコードを作成する場合は可読性や整理を忘れずに: 最初に試行錯誤をしていた際に作成されたコードは「UI実装の意図がつかみにくい」場合もあったので、ScrollViewに関する処 理例やAPIドキュメントを確認しながら進めた方が良さそう。 一見シンプルかつ美しいUI実装に見えても中身を紐解くとかなり複雑でシビアな実装をしている事は良くある