shenandshen
54798ba578
- 给全部 78 个 Swift 源文件添加详细的中文注释（文件级、类级、方法级） - 删除 LegacyRDReaderController/ 死代码目录（16 文件 4592 行） - 根目录翻页容器文件移入 ReaderView/ 目录 - Resources/ 移入 EPUBCore/Resources/（与使用者归属一致） - RDEPUBTextIndexTable.swift 移入 EPUBTextRendering/（消除反向依赖） - RDURLReaderController.swift 移入 EPUBUI/（入口控制器归入 UI 层） - 更新 podspec 资源路径
350 lines
14 KiB
Swift
350 lines
14 KiB
Swift
import UIKit
|
|
|
|
// MARK: - 高亮管理面板
|
|
|
|
/// EPUB 阅读器的高亮标注管理控制器
|
|
/// 以列表形式展示所有高亮和批注，支持筛选（全部/批注/高亮）、跳转到位置、编辑批注、删除
|
|
final class RDEPUBReaderHighlightsViewController: UITableViewController {
|
|
/// 用户选择跳转到某个高亮位置时的回调
|
|
var onSelectHighlight: ((RDEPUBHighlight) -> Void)?
|
|
/// 用户编辑高亮批注后的回调
|
|
var onUpdateHighlight: ((RDEPUBHighlight) -> Void)?
|
|
/// 用户删除高亮时的回调
|
|
var onDeleteHighlight: ((RDEPUBHighlight) -> Void)?
|
|
|
|
/// 高亮列表（按创建时间降序排列）
|
|
private var highlights: [RDEPUBHighlight]
|
|
/// 当前主题配置
|
|
private let theme: RDEPUBReaderTheme
|
|
/// 提供章节标题的回调，用于显示高亮所在的章节名
|
|
private let sectionTitleProvider: (RDEPUBHighlight) -> String?
|
|
/// 筛选控件：全部、批注、高亮
|
|
private let filterControl = UISegmentedControl(items: ["全部", "批注", "高亮"])
|
|
|
|
private var filteredHighlights: [RDEPUBHighlight] {
|
|
switch filterControl.selectedSegmentIndex {
|
|
case 1:
|
|
return highlights.filter(\.hasNote)
|
|
case 2:
|
|
return highlights.filter { $0.style == .highlight }
|
|
default:
|
|
return highlights
|
|
}
|
|
}
|
|
|
|
init(
|
|
highlights: [RDEPUBHighlight],
|
|
theme: RDEPUBReaderTheme,
|
|
sectionTitleProvider: @escaping (RDEPUBHighlight) -> String?
|
|
) {
|
|
self.highlights = highlights.sorted { $0.createdAt > $1.createdAt }
|
|
self.theme = theme
|
|
self.sectionTitleProvider = sectionTitleProvider
|
|
super.init(style: .plain)
|
|
title = "标注"
|
|
}
|
|
|
|
required init?(coder: NSCoder) {
|
|
fatalError("init(coder:) has not been implemented")
|
|
}
|
|
|
|
override func viewDidLoad() {
|
|
super.viewDidLoad()
|
|
tableView.tableFooterView = UIView(frame: .zero)
|
|
tableView.separatorInset = UIEdgeInsets(top: 0, left: 16, bottom: 0, right: 16)
|
|
configureFilterControl()
|
|
applyTheme()
|
|
updateEmptyState()
|
|
}
|
|
|
|
override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
|
|
filteredHighlights.count
|
|
}
|
|
|
|
override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
|
|
let cellIdentifier = "HighlightCell"
|
|
let cell = tableView.dequeueReusableCell(withIdentifier: cellIdentifier) ?? UITableViewCell(style: .subtitle, reuseIdentifier: cellIdentifier)
|
|
let highlight = filteredHighlights[indexPath.row]
|
|
|
|
cell.backgroundColor = theme.contentBackgroundColor
|
|
cell.textLabel?.textColor = theme.contentTextColor
|
|
cell.textLabel?.font = UIFont.systemFont(ofSize: 15, weight: .medium)
|
|
cell.textLabel?.numberOfLines = 2
|
|
cell.textLabel?.text = titleText(for: highlight)
|
|
|
|
cell.detailTextLabel?.textColor = theme.contentTextColor.withAlphaComponent(0.7)
|
|
cell.detailTextLabel?.font = UIFont.systemFont(ofSize: 12)
|
|
cell.detailTextLabel?.numberOfLines = 3
|
|
cell.detailTextLabel?.text = detailText(for: highlight)
|
|
cell.accessoryType = .disclosureIndicator
|
|
return cell
|
|
}
|
|
|
|
override func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
|
|
tableView.deselectRow(at: indexPath, animated: true)
|
|
presentActions(for: filteredHighlights[indexPath.row], sourceIndexPath: indexPath)
|
|
}
|
|
|
|
private func configureFilterControl() {
|
|
filterControl.selectedSegmentIndex = 0
|
|
filterControl.addTarget(self, action: #selector(filterChangedAction), for: .valueChanged)
|
|
navigationItem.titleView = filterControl
|
|
}
|
|
|
|
private func applyTheme() {
|
|
tableView.backgroundColor = theme.contentBackgroundColor
|
|
navigationController?.navigationBar.tintColor = theme.toolControlTextColor
|
|
navigationController?.navigationBar.barTintColor = theme.toolBackgroundColor
|
|
navigationController?.navigationBar.titleTextAttributes = [.foregroundColor: theme.toolControlTextColor]
|
|
}
|
|
|
|
private func updateEmptyState() {
|
|
guard filteredHighlights.isEmpty else {
|
|
tableView.backgroundView = nil
|
|
return
|
|
}
|
|
|
|
let label = UILabel()
|
|
label.text = emptyStateText()
|
|
label.textAlignment = .center
|
|
label.textColor = theme.contentTextColor.withAlphaComponent(0.7)
|
|
label.numberOfLines = 0
|
|
tableView.backgroundView = label
|
|
}
|
|
|
|
@objc private func filterChangedAction() {
|
|
tableView.reloadData()
|
|
updateEmptyState()
|
|
}
|
|
|
|
private func emptyStateText() -> String {
|
|
switch filterControl.selectedSegmentIndex {
|
|
case 1:
|
|
return "暂无批注"
|
|
case 2:
|
|
return "暂无划线"
|
|
default:
|
|
return "暂无标注"
|
|
}
|
|
}
|
|
|
|
private func detailText(for highlight: RDEPUBHighlight) -> String {
|
|
let style = styleDescription(for: highlight)
|
|
let chapter = sectionTitleProvider(highlight)
|
|
let note = normalizedNote(highlight.note)
|
|
let parts = [style, chapter, note].compactMap { $0 }
|
|
if !parts.isEmpty {
|
|
return parts.joined(separator: "\n")
|
|
}
|
|
return highlight.location.href
|
|
}
|
|
|
|
private func titleText(for highlight: RDEPUBHighlight) -> String {
|
|
let text = highlight.text.trimmingCharacters(in: .whitespacesAndNewlines)
|
|
if highlight.hasNote {
|
|
return "批注: \(text)"
|
|
}
|
|
return text
|
|
}
|
|
|
|
private func styleDescription(for highlight: RDEPUBHighlight) -> String {
|
|
switch highlight.style {
|
|
case .highlight:
|
|
return highlight.hasNote ? "高亮批注" : "高亮"
|
|
case .underline:
|
|
return highlight.hasNote ? "划线批注" : "划线"
|
|
}
|
|
}
|
|
|
|
private func presentActions(for highlight: RDEPUBHighlight, sourceIndexPath: IndexPath) {
|
|
let alert = UIAlertController(title: "标注管理", message: nil, preferredStyle: .actionSheet)
|
|
alert.addAction(UIAlertAction(title: "跳转到位置", style: .default) { [weak self] _ in
|
|
self?.onSelectHighlight?(highlight)
|
|
})
|
|
alert.addAction(UIAlertAction(title: "编辑批注", style: .default) { [weak self] _ in
|
|
self?.presentNoteEditor(for: highlight)
|
|
})
|
|
alert.addAction(UIAlertAction(title: "删除标注", style: .destructive) { [weak self] _ in
|
|
self?.deleteHighlight(highlight)
|
|
})
|
|
alert.addAction(UIAlertAction(title: "取消", style: .cancel))
|
|
|
|
if let popover = alert.popoverPresentationController,
|
|
let cell = tableView.cellForRow(at: sourceIndexPath) {
|
|
popover.sourceView = cell
|
|
popover.sourceRect = cell.bounds
|
|
}
|
|
|
|
present(alert, animated: true)
|
|
}
|
|
|
|
private func presentNoteEditor(for highlight: RDEPUBHighlight) {
|
|
let alert = UIAlertController(title: "编辑批注", message: nil, preferredStyle: .alert)
|
|
alert.addTextField { textField in
|
|
textField.placeholder = "输入批注内容"
|
|
textField.text = highlight.note
|
|
}
|
|
alert.addAction(UIAlertAction(title: "取消", style: .cancel))
|
|
alert.addAction(UIAlertAction(title: "保存", style: .default) { [weak self, weak alert] _ in
|
|
guard let self,
|
|
let note = alert?.textFields?.first?.text,
|
|
let index = self.highlights.firstIndex(where: { $0.id == highlight.id }) else {
|
|
return
|
|
}
|
|
|
|
var updated = highlight
|
|
updated.note = self.normalizedNote(note)
|
|
self.highlights[index] = updated
|
|
self.tableView.reloadData()
|
|
self.onUpdateHighlight?(updated)
|
|
self.updateEmptyState()
|
|
})
|
|
present(alert, animated: true)
|
|
}
|
|
|
|
private func deleteHighlight(_ highlight: RDEPUBHighlight) {
|
|
guard let index = highlights.firstIndex(where: { $0.id == highlight.id }) else { return }
|
|
highlights.remove(at: index)
|
|
tableView.reloadData()
|
|
onDeleteHighlight?(highlight)
|
|
updateEmptyState()
|
|
}
|
|
|
|
private func normalizedNote(_ note: String?) -> String? {
|
|
let trimmed = note?.trimmingCharacters(in: .whitespacesAndNewlines) ?? ""
|
|
return trimmed.isEmpty ? nil : trimmed
|
|
}
|
|
}
|
|
|
|
// MARK: - 书签管理面板
|
|
|
|
/// EPUB 阅读器的书签管理控制器
|
|
/// 以列表形式展示所有书签，支持跳转到书签位置和删除书签
|
|
final class RDEPUBReaderBookmarksViewController: UITableViewController {
|
|
/// 用户选择跳转到某个书签位置时的回调
|
|
var onSelectBookmark: ((RDEPUBBookmark) -> Void)?
|
|
/// 用户删除书签时的回调
|
|
var onDeleteBookmark: ((RDEPUBBookmark) -> Void)?
|
|
|
|
private var bookmarks: [RDEPUBBookmark]
|
|
private let theme: RDEPUBReaderTheme
|
|
private let dateFormatter: DateFormatter = {
|
|
let formatter = DateFormatter()
|
|
formatter.dateFormat = "yyyy-MM-dd HH:mm"
|
|
return formatter
|
|
}()
|
|
|
|
init(bookmarks: [RDEPUBBookmark], theme: RDEPUBReaderTheme) {
|
|
self.bookmarks = bookmarks.sorted { $0.createdAt > $1.createdAt }
|
|
self.theme = theme
|
|
super.init(style: .plain)
|
|
title = "书签"
|
|
}
|
|
|
|
required init?(coder: NSCoder) {
|
|
fatalError("init(coder:) has not been implemented")
|
|
}
|
|
|
|
override func viewDidLoad() {
|
|
super.viewDidLoad()
|
|
tableView.tableFooterView = UIView(frame: .zero)
|
|
tableView.separatorInset = UIEdgeInsets(top: 0, left: 16, bottom: 0, right: 16)
|
|
applyTheme()
|
|
updateEmptyState()
|
|
}
|
|
|
|
override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
|
|
bookmarks.count
|
|
}
|
|
|
|
override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
|
|
let cellIdentifier = "BookmarkCell"
|
|
let cell = tableView.dequeueReusableCell(withIdentifier: cellIdentifier) ?? UITableViewCell(style: .subtitle, reuseIdentifier: cellIdentifier)
|
|
let bookmark = bookmarks[indexPath.row]
|
|
|
|
cell.backgroundColor = theme.contentBackgroundColor
|
|
cell.textLabel?.textColor = theme.contentTextColor
|
|
cell.textLabel?.font = UIFont.systemFont(ofSize: 15, weight: .medium)
|
|
cell.textLabel?.numberOfLines = 2
|
|
cell.textLabel?.text = titleText(for: bookmark)
|
|
|
|
cell.detailTextLabel?.textColor = theme.contentTextColor.withAlphaComponent(0.7)
|
|
cell.detailTextLabel?.font = UIFont.systemFont(ofSize: 12)
|
|
cell.detailTextLabel?.numberOfLines = 3
|
|
cell.detailTextLabel?.text = detailText(for: bookmark)
|
|
cell.accessoryType = .disclosureIndicator
|
|
return cell
|
|
}
|
|
|
|
override func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
|
|
tableView.deselectRow(at: indexPath, animated: true)
|
|
presentActions(for: bookmarks[indexPath.row], sourceIndexPath: indexPath)
|
|
}
|
|
|
|
private func applyTheme() {
|
|
tableView.backgroundColor = theme.contentBackgroundColor
|
|
navigationController?.navigationBar.tintColor = theme.toolControlTextColor
|
|
navigationController?.navigationBar.barTintColor = theme.toolBackgroundColor
|
|
navigationController?.navigationBar.titleTextAttributes = [.foregroundColor: theme.toolControlTextColor]
|
|
}
|
|
|
|
private func updateEmptyState() {
|
|
guard bookmarks.isEmpty == false else {
|
|
let label = UILabel()
|
|
label.text = "暂无书签"
|
|
label.textAlignment = .center
|
|
label.textColor = theme.contentTextColor.withAlphaComponent(0.7)
|
|
label.numberOfLines = 0
|
|
tableView.backgroundView = label
|
|
return
|
|
}
|
|
tableView.backgroundView = nil
|
|
}
|
|
|
|
private func titleText(for bookmark: RDEPUBBookmark) -> String {
|
|
if let chapterTitle = bookmark.chapterTitle, !chapterTitle.isEmpty {
|
|
return chapterTitle
|
|
}
|
|
return bookmark.location.href
|
|
}
|
|
|
|
private func detailText(for bookmark: RDEPUBBookmark) -> String {
|
|
let parts = [
|
|
dateFormatter.string(from: bookmark.createdAt),
|
|
bookmark.note?.trimmingCharacters(in: .whitespacesAndNewlines),
|
|
bookmark.location.href
|
|
].compactMap { value -> String? in
|
|
guard let value, !value.isEmpty else { return nil }
|
|
return value
|
|
}
|
|
return parts.joined(separator: "\n")
|
|
}
|
|
|
|
private func presentActions(for bookmark: RDEPUBBookmark, sourceIndexPath: IndexPath) {
|
|
let alert = UIAlertController(title: "书签管理", message: nil, preferredStyle: .actionSheet)
|
|
alert.addAction(UIAlertAction(title: "跳转到位置", style: .default) { [weak self] _ in
|
|
self?.onSelectBookmark?(bookmark)
|
|
})
|
|
alert.addAction(UIAlertAction(title: "删除书签", style: .destructive) { [weak self] _ in
|
|
self?.deleteBookmark(bookmark)
|
|
})
|
|
alert.addAction(UIAlertAction(title: "取消", style: .cancel))
|
|
|
|
if let popover = alert.popoverPresentationController,
|
|
let cell = tableView.cellForRow(at: sourceIndexPath) {
|
|
popover.sourceView = cell
|
|
popover.sourceRect = cell.bounds
|
|
}
|
|
|
|
present(alert, animated: true)
|
|
}
|
|
|
|
private func deleteBookmark(_ bookmark: RDEPUBBookmark) {
|
|
guard let index = bookmarks.firstIndex(where: { $0.id == bookmark.id }) else { return }
|
|
bookmarks.remove(at: index)
|
|
tableView.reloadData()
|
|
onDeleteBookmark?(bookmark)
|
|
updateEmptyState()
|
|
}
|
|
}
|