源码注释: - 为 ~60 个 Swift 文件补充缺失的 doc comment(file header、类型、属性、方法) - 修正 4 处错误注释:翻页模式数量、搜索行为描述、手势识别器描述、悬空文档块 文档维护: - 删除重复文档:WXRead/读书EPUB阅读器实现架构.md(与微信读书版完全一致) - 合并重叠文档:阅读器规划.md → 阅读器功能开发计划.md(单一真值) - 修正过时内容:所有文档中"四种翻页模式"→"三种",移除 horizontalCoverScroll - 更新架构图:补齐 EPUBUI/ReaderController、Paging/、Typesetter/ 等子目录 - 更新 index.md 索引:新增开发计划和架构对比文档引用
127 lines
5.1 KiB
Swift
127 lines
5.1 KiB
Swift
//
|
|
// RDReaderView+ToolView.swift
|
|
// ReadViewSDK
|
|
//
|
|
// 文件职责:工具栏管理扩展,处理工具栏的显示/隐藏动画、安装和布局约束。
|
|
//
|
|
|
|
import UIKit
|
|
|
|
/// 工具栏管理扩展:处理工具栏的显示/隐藏动画、安装、布局
|
|
extension RDReaderView {
|
|
|
|
/// 点击屏幕中央区域,切换工具栏的显示/隐藏,带动画效果
|
|
func tapCenter() {
|
|
refreshToolViewsFromProviderIfNeeded()
|
|
isShowToolView = !isShowToolView
|
|
if isShowToolView {
|
|
if let topToolView = topToolView {
|
|
installToolViewIfNeeded(topToolView, position: .top)
|
|
layoutIfNeeded()
|
|
topToolView.transform = CGAffineTransform(translationX: 0, y: -topToolView.bounds.height)
|
|
UIView.animate(withDuration: toolViewAnimationDuration) {
|
|
topToolView.transform = .identity
|
|
}
|
|
}
|
|
|
|
if let bottomToolView = bottomToolView {
|
|
installToolViewIfNeeded(bottomToolView, position: .bottom)
|
|
layoutIfNeeded()
|
|
bottomToolView.transform = CGAffineTransform(translationX: 0, y: bottomToolView.bounds.height)
|
|
UIView.animate(withDuration: toolViewAnimationDuration) {
|
|
bottomToolView.transform = .identity
|
|
}
|
|
}
|
|
|
|
collectionView.isUserInteractionEnabled = false
|
|
pageViewController.view.isUserInteractionEnabled = false
|
|
} else {
|
|
if let topToolView = topToolView {
|
|
UIView.animate(withDuration: toolViewAnimationDuration, animations: {
|
|
topToolView.transform = CGAffineTransform(translationX: 0, y: -topToolView.bounds.height)
|
|
}) { _ in
|
|
topToolView.removeFromSuperview()
|
|
}
|
|
}
|
|
|
|
if let bottomToolView = bottomToolView {
|
|
UIView.animate(withDuration: toolViewAnimationDuration, animations: {
|
|
bottomToolView.transform = CGAffineTransform(translationX: 0, y: bottomToolView.bounds.height)
|
|
}) { _ in
|
|
bottomToolView.removeFromSuperview()
|
|
}
|
|
}
|
|
|
|
collectionView.isUserInteractionEnabled = true
|
|
pageViewController.view.isUserInteractionEnabled = true
|
|
}
|
|
}
|
|
|
|
/// 判断点击命中的视图是否在指定工具栏内,用于决定是否拦截点击事件
|
|
func isHitView(_ hitView: UIView?, inside toolView: UIView, point: CGPoint) -> Bool {
|
|
if toolView.frame.contains(point) {
|
|
return true
|
|
}
|
|
|
|
guard let hitView else { return false }
|
|
return hitView === toolView || hitView.isDescendant(of: toolView)
|
|
}
|
|
|
|
/// 工具栏位置枚举
|
|
enum ToolViewPosition {
|
|
/// 顶部工具栏(如标题栏、导航栏)
|
|
case top
|
|
/// 底部工具栏(如进度条、操作按钮)
|
|
case bottom
|
|
}
|
|
|
|
/// 将工具栏安装到指定位置并设置布局约束,已安装则跳过
|
|
func installToolViewIfNeeded(_ toolView: UIView, position: ToolViewPosition) {
|
|
guard toolView.superview !== self else { return }
|
|
|
|
toolView.removeFromSuperview()
|
|
addSubview(toolView)
|
|
toolView.translatesAutoresizingMaskIntoConstraints = false
|
|
|
|
let heightConstraint: NSLayoutConstraint
|
|
switch position {
|
|
case .top:
|
|
topToolViewHeightConstraint?.isActive = false
|
|
heightConstraint = toolView.heightAnchor.constraint(equalToConstant: resolvedToolViewHeight(for: .top))
|
|
topToolViewHeightConstraint = heightConstraint
|
|
NSLayoutConstraint.activate([
|
|
toolView.leadingAnchor.constraint(equalTo: leadingAnchor),
|
|
toolView.trailingAnchor.constraint(equalTo: trailingAnchor),
|
|
toolView.topAnchor.constraint(equalTo: topAnchor),
|
|
heightConstraint
|
|
])
|
|
case .bottom:
|
|
bottomToolViewHeightConstraint?.isActive = false
|
|
heightConstraint = toolView.heightAnchor.constraint(equalToConstant: resolvedToolViewHeight(for: .bottom))
|
|
bottomToolViewHeightConstraint = heightConstraint
|
|
NSLayoutConstraint.activate([
|
|
toolView.leadingAnchor.constraint(equalTo: leadingAnchor),
|
|
toolView.trailingAnchor.constraint(equalTo: trailingAnchor),
|
|
toolView.bottomAnchor.constraint(equalTo: bottomAnchor),
|
|
heightConstraint
|
|
])
|
|
}
|
|
}
|
|
|
|
/// 更新顶部和底部工具栏的高度约束,通常在 safeAreaInsets 变化时调用
|
|
func updateToolViewHeightConstraintsIfNeeded() {
|
|
topToolViewHeightConstraint?.constant = resolvedToolViewHeight(for: .top)
|
|
bottomToolViewHeightConstraint?.constant = resolvedToolViewHeight(for: .bottom)
|
|
}
|
|
|
|
private func resolvedToolViewHeight(for position: ToolViewPosition) -> CGFloat {
|
|
let contentHeight: CGFloat = 52
|
|
switch position {
|
|
case .top:
|
|
return safeAreaInsets.top + contentHeight
|
|
case .bottom:
|
|
return safeAreaInsets.bottom + contentHeight
|
|
}
|
|
}
|
|
}
|