54798ba578
- 给全部 78 个 Swift 源文件添加详细的中文注释（文件级、类级、方法级） - 删除 LegacyRDReaderController/ 死代码目录（16 文件 4592 行） - 根目录翻页容器文件移入 ReaderView/ 目录 - Resources/ 移入 EPUBCore/Resources/（与使用者归属一致） - RDEPUBTextIndexTable.swift 移入 EPUBTextRendering/（消除反向依赖） - RDURLReaderController.swift 移入 EPUBUI/（入口控制器归入 UI 层） - 更新 podspec 资源路径
97 lines
3.8 KiB
Swift
97 lines
3.8 KiB
Swift
// RDEPUBWebView+FixedLayout.swift
|
||
// RDEPUBWebView 的固定版式渲染扩展
|
||
// 处理固定版式（Fixed Layout）的加载流程：生成 HTML 模板、
|
||
// 计算加载签名（去重）、设置固定版式就绪回退定时器等。
|
||
|
||
import UIKit
|
||
import WebKit
|
||
|
||
extension RDEPUBWebView {
|
||
/// 便捷方法：加载固定版式的 spread 页面
|
||
public func loadFixedSpread(
|
||
parser: RDEPUBParser,
|
||
spread: EPUBFixedSpread,
|
||
viewportSize: CGSize,
|
||
contentInset: UIEdgeInsets,
|
||
backgroundColor: UIColor?
|
||
) {
|
||
let request = RDEPUBRenderRequest.fixed(
|
||
RDEPUBFixedRenderRequest(
|
||
spread: spread,
|
||
viewportSize: viewportSize,
|
||
contentInset: contentInset,
|
||
backgroundColorCSS: backgroundColor?.ss_hexString,
|
||
fit: .page,
|
||
searchPresentation: nil
|
||
)
|
||
)
|
||
load(publication: parser.makePublication(), request: request)
|
||
}
|
||
|
||
/// 处理固定版式加载：设置状态、生成 HTML、加载到 WebView
|
||
func handleFixedLayoutLoad(
|
||
publication: RDEPUBPublication,
|
||
request: RDEPUBFixedRenderRequest,
|
||
loadSignature: String,
|
||
in webView: WKWebView
|
||
) {
|
||
currentPageIndex = 0
|
||
currentTotalPagesInChapter = 1
|
||
viewportSize = request.viewportSize
|
||
currentPadding = request.contentInset
|
||
currentFontSize = 16
|
||
currentLineHeightMultiple = 1.5
|
||
currentThemeBackgroundColor = request.backgroundColorCSS
|
||
currentThemeTextColor = nil
|
||
targetLocation = nil
|
||
pendingHighlights = []
|
||
fixedSpread = request.spread
|
||
isFixedLayout = true
|
||
pendingProgressionRequest = false
|
||
currentLoadSignature = loadSignature
|
||
scheduleFixedLayoutReadyFallback()
|
||
|
||
let html = RDEPUBFixedLayoutTemplate.html(for: request, publication: publication)
|
||
RDEPUBWebViewDebug.log(debugScope, message: "load fixed spread resources=\(request.spread.resources.map(\.href).joined(separator: ",")) fit=\(request.fit.rawValue)")
|
||
webView.loadHTMLString(
|
||
html,
|
||
baseURL: URL(string: "\(RDEPUBResourceURLSchemeHandler.scheme)://\(RDEPUBResourceURLSchemeHandler.host)/")
|
||
)
|
||
}
|
||
|
||
/// 生成固定版式加载签名（用于去重相同请求）
|
||
func fixedLayoutLoadSignature(publicationKey: String, request: RDEPUBFixedRenderRequest) -> String {
|
||
[
|
||
publicationKey,
|
||
"fixed",
|
||
request.spread.resources.map(\.href).joined(separator: "|"),
|
||
String(format: "%.2f", request.viewportSize.width),
|
||
String(format: "%.2f", request.viewportSize.height),
|
||
String(format: "%.2f", request.contentInset.top),
|
||
String(format: "%.2f", request.contentInset.left),
|
||
String(format: "%.2f", request.contentInset.bottom),
|
||
String(format: "%.2f", request.contentInset.right),
|
||
request.backgroundColorCSS ?? "",
|
||
request.fit.rawValue
|
||
].joined(separator: "#")
|
||
}
|
||
|
||
/// 调度固定版式就绪回退定时器（1 秒后如果未收到 ready 消息则手动触发渲染完成）
|
||
func scheduleFixedLayoutReadyFallback() {
|
||
let workItem = DispatchWorkItem { [weak self] in
|
||
RDEPUBWebViewDebug.log(self?.debugScope ?? "ReaderWebView", message: "fixed ready fallback fired")
|
||
self?.applySearchDecorationsIfNeeded {
|
||
self?.rendered()
|
||
}
|
||
}
|
||
fixedLayoutReadyWorkItem = workItem
|
||
DispatchQueue.main.asyncAfter(deadline: .now() + 1.0, execute: workItem)
|
||
}
|
||
|
||
/// 取消固定版式就绪回退定时器
|
||
func cancelFixedLayoutReadyFallback() {
|
||
fixedLayoutReadyWorkItem?.cancel()
|
||
fixedLayoutReadyWorkItem = nil
|
||
}
|
||
}
|