Files
ReadViewSDK/Sources/RDReaderView/EPUBCore/RDEPUBNavigatorLayoutContext.swift
T
shenandshen 54798ba578 refactor: 添加中文注释 + 优化模块结构
- 给全部 78 个 Swift 源文件添加详细的中文注释(文件级、类级、方法级)
- 删除 LegacyRDReaderController/ 死代码目录(16 文件 4592 行)
- 根目录翻页容器文件移入 ReaderView/ 目录
- Resources/ 移入 EPUBCore/Resources/(与使用者归属一致)
- RDEPUBTextIndexTable.swift 移入 EPUBTextRendering/(消除反向依赖)
- RDURLReaderController.swift 移入 EPUBUI/(入口控制器归入 UI 层)
- 更新 podspec 资源路径
2026-05-25 10:19:14 +08:00

59 lines
2.3 KiB
Swift

// RDEPUBNavigatorLayoutContext.swift
// 导航器布局上下文
// 封装阅读器容器的布局参数:容器尺寸、每屏页数、安全区域、设备类型、
// 重排内容内边距等,供 Paginator 和渲染层使用。
import UIKit
/// 导航器布局上下文,描述阅读器容器的布局参数
/// 在 Paginator 计算分页和 WebView 渲染时作为核心输入
public struct RDEPUBNavigatorLayoutContext: Equatable {
/// 容器视图的总尺寸
public var containerSize: CGSize
/// 每屏显示的页数(横屏双页模式为 2)
public var pagesPerScreen: Int
/// 安全区域内边距(刘海屏、Home Indicator 等)
public var safeAreaInsets: UIEdgeInsets
/// 用户界面设备类型(phone/pad)
public var userInterfaceIdiom: UIUserInterfaceIdiom
/// 重排模式下的内容内边距(上下左右留白)
public var reflowableContentInsets: UIEdgeInsets
public init(
containerSize: CGSize,
pagesPerScreen: Int = 1,
safeAreaInsets: UIEdgeInsets = .zero,
userInterfaceIdiom: UIUserInterfaceIdiom = .phone,
reflowableContentInsets: UIEdgeInsets = UIEdgeInsets(top: 40, left: 16, bottom: 40, right: 16)
) {
self.containerSize = containerSize
self.pagesPerScreen = max(1, pagesPerScreen)
self.safeAreaInsets = safeAreaInsets
self.userInterfaceIdiom = userInterfaceIdiom
self.reflowableContentInsets = reflowableContentInsets
}
/// 计算单页视口尺寸(双页模式下宽度除以 2)
public var viewportSize: CGSize {
let width: CGFloat
if pagesPerScreen > 1 {
width = containerSize.width / CGFloat(pagesPerScreen)
} else {
width = containerSize.width
}
return CGSize(width: width, height: containerSize.height)
}
/// 固定版式模式下的内容内边距(仅手机端使用安全区域,Pad 端归零;左右取较大值对称)
public var fixedContentInset: UIEdgeInsets {
var insets = safeAreaInsets
if userInterfaceIdiom != .phone {
insets = .zero
}
let horizontalInsets = max(insets.left, insets.right)
insets.left = horizontalInsets
insets.right = horizontalInsets
return insets
}
}