279 lines
9.2 KiB
Swift
279 lines
9.2 KiB
Swift
|
|
import UIKit
|
|
import WebKit
|
|
|
|
public protocol RDEPUBWebViewDelegate: AnyObject {
|
|
|
|
func epubWebView(_ webView: RDEPUBWebView, didUpdateLocation location: RDEPUBLocation, spineIndex: Int)
|
|
|
|
func epubWebView(_ webView: RDEPUBWebView, didChangeSelection selection: RDEPUBSelection?, spineIndex: Int)
|
|
|
|
func epubWebView(_ webView: RDEPUBWebView, didRequestSelectionAction action: RDEPUBAnnotationMenuAction)
|
|
|
|
func epubWebView(_ webView: RDEPUBWebView, didActivateInternalLink location: RDEPUBLocation, fromSpineIndex: Int)
|
|
|
|
func epubWebView(_ webView: RDEPUBWebView, didActivateExternalLink url: URL)
|
|
|
|
func epubWebView(_ webView: RDEPUBWebView, didLogJavaScriptError message: String)
|
|
|
|
func epubWebViewDidFinishRendering(_ webView: RDEPUBWebView)
|
|
|
|
func epubWebView(_ webView: RDEPUBWebView, didTapImageWithSource src: String, sourceRect: CGRect?)
|
|
|
|
func epubWebView(_ webView: RDEPUBWebView, didTapFootnoteWithAltText altText: String, sourceRect: CGRect?)
|
|
}
|
|
|
|
public extension RDEPUBWebViewDelegate {
|
|
func epubWebView(_ webView: RDEPUBWebView, didRequestSelectionAction action: RDEPUBAnnotationMenuAction) {}
|
|
func epubWebView(_ webView: RDEPUBWebView, didTapImageWithSource src: String, sourceRect: CGRect?) {}
|
|
func epubWebView(_ webView: RDEPUBWebView, didTapFootnoteWithAltText altText: String, sourceRect: CGRect?) {}
|
|
}
|
|
|
|
final class RDEPUBAnnotationWebView: WKWebView {
|
|
|
|
var onSelectionAction: ((RDEPUBAnnotationMenuAction) -> Void)?
|
|
|
|
// M-15: Backing store for UIEditMenuInteraction (iOS 16+).
|
|
// Stored as Any? to avoid @available on stored property restriction.
|
|
var _editMenuInteraction: Any?
|
|
|
|
override var canBecomeFirstResponder: Bool {
|
|
true
|
|
}
|
|
|
|
override func canPerformAction(_ action: Selector, withSender sender: Any?) -> Bool {
|
|
switch action {
|
|
case #selector(rd_copy(_:)),
|
|
#selector(rd_highlight(_:)),
|
|
#selector(rd_annotate(_:)):
|
|
return true
|
|
default:
|
|
return false
|
|
}
|
|
}
|
|
|
|
@objc func rd_copy(_ sender: Any?) {
|
|
onSelectionAction?(.copy)
|
|
}
|
|
|
|
@objc func rd_highlight(_ sender: Any?) {
|
|
onSelectionAction?(.highlight)
|
|
}
|
|
|
|
@objc func rd_annotate(_ sender: Any?) {
|
|
onSelectionAction?(.annotate)
|
|
}
|
|
}
|
|
|
|
// MARK: - UIEditMenuInteractionDelegate (iOS 16+)
|
|
|
|
@available(iOS 16.0, *)
|
|
extension RDEPUBAnnotationWebView: UIEditMenuInteractionDelegate {
|
|
func editMenuInteraction(
|
|
_ interaction: UIEditMenuInteraction,
|
|
menuFor configuration: UIEditMenuConfiguration
|
|
) -> UIMenu {
|
|
UIMenu(children: [
|
|
UICommand(title: "复制", action: #selector(rd_copy(_:))),
|
|
UICommand(title: "划线", action: #selector(rd_highlight(_:))),
|
|
UICommand(title: "注释", action: #selector(rd_annotate(_:)))
|
|
])
|
|
}
|
|
|
|
func editMenuInteraction(
|
|
_ interaction: UIEditMenuInteraction,
|
|
targetRectFor configuration: UIEditMenuConfiguration
|
|
) -> CGRect {
|
|
bounds
|
|
}
|
|
}
|
|
|
|
public final class RDEPUBWebView: UIView {
|
|
|
|
public weak var delegate: RDEPUBWebViewDelegate?
|
|
|
|
public var onRendered: (() -> Void)?
|
|
|
|
var onDecorationsResolved: (([RDEPUBTextOverlayDecoration]) -> Void)?
|
|
|
|
var publication: RDEPUBPublication?
|
|
|
|
var currentRenderRequest: RDEPUBRenderRequest?
|
|
|
|
var webView: WKWebView?
|
|
|
|
var schemeHandler: RDEPUBResourceURLSchemeHandler?
|
|
|
|
var configuredPublicationKey: String?
|
|
|
|
var currentLoadSignature: String?
|
|
|
|
var currentSpineIndex = 0
|
|
|
|
var currentHref = ""
|
|
|
|
var currentPageIndex = 0
|
|
|
|
var currentTotalPagesInChapter = 1
|
|
|
|
var viewportSize: CGSize = .zero
|
|
|
|
var currentPadding: UIEdgeInsets = .zero
|
|
|
|
var currentFontSize: CGFloat = 16
|
|
|
|
var currentLineHeightMultiple: CGFloat = 1.5
|
|
|
|
var currentThemeBackgroundColor: String?
|
|
|
|
var currentThemeTextColor: String?
|
|
|
|
var targetLocation: RDEPUBLocation?
|
|
|
|
var pendingHighlights: [RDEPUBHighlight] = []
|
|
|
|
var fixedSpread: EPUBFixedSpread?
|
|
|
|
var isFixedLayout = false
|
|
|
|
var isReaderPageVisible = true
|
|
|
|
var hasReaderPageBeenVisible = false
|
|
|
|
var needsReaderPagePlaybackRestart = false
|
|
|
|
var appliedNativeMediaPlaybackSuspended = false
|
|
|
|
var isNativeMediaPlaybackOperationInFlight = false
|
|
|
|
var nativeMediaPlaybackOperationGeneration: UInt = 0
|
|
|
|
var nativeMediaPlaybackRequests: [(suspended: Bool, completion: () -> Void)] = []
|
|
|
|
var isWaitingForReaderPageMediaNavigation = false
|
|
|
|
var pendingReaderPageMediaNavigation: WKNavigation?
|
|
|
|
var isReaderPageMediaActivationBlocked = false
|
|
|
|
var pendingProgressionRequest = false
|
|
|
|
var fixedLayoutReadyWorkItem: DispatchWorkItem?
|
|
|
|
var didRenderCurrentRequest = false
|
|
|
|
let debugScope = "ReaderWebView"
|
|
|
|
public override init(frame: CGRect) {
|
|
super.init(frame: frame)
|
|
backgroundColor = .clear
|
|
}
|
|
|
|
required init?(coder: NSCoder) {
|
|
fatalError("init(coder:) has not been implemented")
|
|
}
|
|
|
|
// M-08: script message handler 经 RDEPUBWeakScriptMessageHandler 弱代理注册
|
|
// （见 configureWebViewIfNeeded），webView → userContentController → self
|
|
// 的保留环不再成立，deinit 会随最后一个持有者释放而正常触发。
|
|
// reset() 仍可用于在丢弃路径上提前拆除 WKWebView（不必等 dealloc）。
|
|
deinit {
|
|
teardownWebView()
|
|
}
|
|
|
|
public override func layoutSubviews() {
|
|
super.layoutSubviews()
|
|
webView?.frame = bounds
|
|
}
|
|
|
|
public func reset() {
|
|
delegate = nil
|
|
onRendered = nil
|
|
onDecorationsResolved = nil
|
|
publication = nil
|
|
currentRenderRequest = nil
|
|
currentSpineIndex = 0
|
|
currentHref = ""
|
|
currentPageIndex = 0
|
|
currentTotalPagesInChapter = 1
|
|
viewportSize = .zero
|
|
currentPadding = .zero
|
|
currentFontSize = 16
|
|
currentLineHeightMultiple = 1.5
|
|
currentThemeBackgroundColor = nil
|
|
currentThemeTextColor = nil
|
|
targetLocation = nil
|
|
pendingHighlights = []
|
|
fixedSpread = nil
|
|
isFixedLayout = false
|
|
isReaderPageVisible = true
|
|
hasReaderPageBeenVisible = false
|
|
needsReaderPagePlaybackRestart = false
|
|
isWaitingForReaderPageMediaNavigation = false
|
|
pendingReaderPageMediaNavigation = nil
|
|
isReaderPageMediaActivationBlocked = false
|
|
pendingProgressionRequest = false
|
|
didRenderCurrentRequest = false
|
|
teardownWebView()
|
|
}
|
|
|
|
public func load(publication: RDEPUBPublication, request: RDEPUBRenderRequest) {
|
|
configureWebViewIfNeeded(publication: publication)
|
|
guard let webView else { return }
|
|
|
|
self.publication = publication
|
|
self.currentRenderRequest = request
|
|
self.currentSpineIndex = request.primarySpineIndex
|
|
self.currentHref = request.primaryHref
|
|
self.didRenderCurrentRequest = false
|
|
cancelFixedLayoutReadyFallback()
|
|
|
|
let publicationKey = publication.parser.opfURL?.path ?? publication.parser.extractionRootURL?.path ?? ""
|
|
let loadSignature = pageLoadSignature(publicationKey: publicationKey, request: request)
|
|
if request.isFixedLayout {
|
|
// A fixed-layout load replaces the whole Hype document. Keep WebKit
|
|
// suspended until navigation finishes so the outgoing page cannot
|
|
// overlap the new page's zero-second narration.
|
|
hasReaderPageBeenVisible = false
|
|
needsReaderPagePlaybackRestart = false
|
|
isWaitingForReaderPageMediaNavigation = true
|
|
setNativeReaderPageMediaPlaybackSuspended(true)
|
|
}
|
|
RDEPUBWebViewDebug.log(
|
|
debugScope,
|
|
message: "load request=\(request.isFixedLayout ? "fixed" : "reflowable") signature=\(loadSignature) webView=\(RDEPUBWebViewDebug.webViewID(webView))"
|
|
)
|
|
|
|
switch request {
|
|
case .reflowable(let reflowableRequest):
|
|
handleReflowableLoad(publication: publication, request: reflowableRequest, loadSignature: loadSignature, in: webView)
|
|
case .fixed(let fixedRequest):
|
|
handleFixedLayoutLoad(publication: publication, request: fixedRequest, loadSignature: loadSignature, in: webView)
|
|
}
|
|
}
|
|
|
|
func pageLoadSignature(
|
|
publicationKey: String,
|
|
request: RDEPUBRenderRequest
|
|
) -> String {
|
|
switch request {
|
|
case .reflowable(let request):
|
|
return reflowableLoadSignature(publicationKey: publicationKey, request: request)
|
|
case .fixed(let request):
|
|
return fixedLayoutLoadSignature(publicationKey: publicationKey, request: request)
|
|
}
|
|
}
|
|
|
|
func rendered() {
|
|
guard !didRenderCurrentRequest else { return }
|
|
didRenderCurrentRequest = true
|
|
cancelFixedLayoutReadyFallback()
|
|
RDEPUBWebViewDebug.log(debugScope, message: "rendered spine=\(currentSpineIndex) href=\(currentHref) fixed=\(isFixedLayout)")
|
|
DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) { [weak self] in
|
|
guard let self else { return }
|
|
self.delegate?.epubWebViewDidFinishRendering(self)
|
|
self.onRendered?()
|
|
}
|
|
}
|
|
}
|