60 lines
2.2 KiB
Swift
60 lines
2.2 KiB
Swift
import UIKit
|
||
|
||
/// 翻页控制器：管理 UIPageViewController 的创建、切换、故障修复和翻页请求队列。
|
||
///
|
||
/// RDReaderView 持有此控制器，将 pageCurl 模式的容器管理职责下沉。
|
||
struct RDReaderPagingController {
|
||
/// 当前 pageCurl 翻页请求模型
|
||
struct PageTransitionRequest: Equatable {
|
||
let pageNum: Int
|
||
let animated: Bool
|
||
}
|
||
|
||
/// 排队中的翻页请求（pageCurl 动画过程中收到新跳转时排队）
|
||
var pendingTransitionRequest: PageTransitionRequest?
|
||
|
||
/// 是否正在执行页面转场动画
|
||
var isTransitioning: Bool = false
|
||
|
||
/// UI 是否已经构建完成（避免重复构建）
|
||
var didBuildUI = false
|
||
|
||
// MARK: - PageViewController 工厂
|
||
|
||
/// 创建带指定 spine 位置的 UIPageViewController
|
||
static func createPageViewController(isDualPage: Bool) -> UIPageViewController {
|
||
let options: [UIPageViewController.OptionsKey: Any]?
|
||
if isDualPage {
|
||
options = [.spineLocation: NSNumber(value: UIPageViewController.SpineLocation.mid.rawValue)]
|
||
} else {
|
||
options = nil
|
||
}
|
||
let pageVC = UIPageViewController(transitionStyle: .pageCurl, navigationOrientation: .horizontal, options: options)
|
||
pageVC.isDoubleSided = isDualPage
|
||
return pageVC
|
||
}
|
||
|
||
// MARK: - 翻页请求队列管理
|
||
|
||
/// pageCurl 动画过程中如果收到新的跳转请求，则排队等待当前动画结束。
|
||
mutating func shouldQueuePageTransition(_ request: PageTransitionRequest, currentDisplayType: RDReaderView.DisplayType) -> Bool {
|
||
guard currentDisplayType == .pageCurl, isTransitioning else { return false }
|
||
pendingTransitionRequest = request
|
||
return true
|
||
}
|
||
|
||
/// 收尾 pageCurl 转场，返回排队中的后续请求（如果有的话）。
|
||
mutating func finishPageCurlTransition() -> PageTransitionRequest? {
|
||
isTransitioning = false
|
||
guard let pending = pendingTransitionRequest else { return nil }
|
||
pendingTransitionRequest = nil
|
||
return pending
|
||
}
|
||
|
||
/// 重置所有排队状态（用于故障修复）。
|
||
mutating func resetPendingState() {
|
||
isTransitioning = false
|
||
pendingTransitionRequest = nil
|
||
}
|
||
}
|