目标
- 使用
TextKit快速分页 - 使用
UIPageViewController
支持平台
iOS, iPadOS
也许还支持
Mac Calalyst ?
使用语言
Swift
视图结构
|- UIViewController // 根视图, 可添加菜单显示, 手势操作等 |- UIPageController // 章节视图, 一页对应一章 | - UIPageController // 章节内容分页视图, 将单章内容进行分页显示 | | - UIViewController // 单页显示视图, 对应单页数据 | | |- UITextView // 文字视图 | | | | - UIViewController | | |- UITextView | | | | ... | | - UIPageController | | - UIViewController | | |- UITextView | | | | - UIViewController | | |- UITextView | | | | ... | | ...
小说系统源码的章节内容分页视图中, 只要在返回单页显示视图的代理中返回
nil, 即可实现章节内容翻到最后一页时, 继续翻页翻到下一章节的逻辑
分页实现
首先,
一定要先确定好 TextView 的大小与内容间距, 即
文字显示区域的大小, 这将严重影响到分页后的数据能不能正常显示
其次, 首行缩进最好用空格代替, 而不是用
NSParagraphStyle 的
firstLineHeadIndent 属性来实现, 否则会出现某段落从中间被分开, 下一页依然被缩进的情况
首行缩进的空格数量可用以下逻辑计算:
let normalWidth = "你好".size(font: textFont).width // 请根据内容语言改变文字 let speaceWidth = " ".size(font: textFont).width // 一个空格的宽 let speaceCount = Int(normalWidth / speaceWidth) let speace = String(repeating: " ", count: speaceCount)
然后在每段前添加空格
let result = content.string.components(separatedBy: "\n").map { "\(speace)\($0)" }
这样就可以在每段首行添加一个合适的缩进了
接下来就是重点的分页了
第一步, 前期参数准备:
-
准备好处理完成的
NSAttributedString, 最好包含各种字体, 颜色, 格式等设置信息, 避免分页视图拿到数据后再次生成NSAttributedString, 重复设置内容样式导致的分页不准的情况 -
准备好文字显示区域大小的参数
第二步, 开始分页:
准备数据:
// 创建 NSLayoutManager, 所有的分页逻辑开端 let layoutManager = NSLayoutManager() // 如果没有给特定部分文字区域设置单独的布局, 可设置此项为 false, 以提高性能 layoutManager.allowsNonContiguousLayout = false // 使用之前准备好的 NSAttributedString 进行初始化 NSTextStorage let textStorage = NSTextStorage(attributedString: string) textStorage.addLayoutManager(layoutManager) // 设定文字显示区域参数 let viewSize: CGSize = CGSize(width: textAreaWidth, height: textAreaHeight) // 设定 textView 的内间距 let textInsets = UIEdgeInsets.zero let textViewFrame = CGRect(x: 0, y: 0, width: viewSize.width, height: viewSize.height) // 开始分页 var glyphRange: Int = 0 var numberOfGlyphs: Int = 0
分页循环:
var ranges: [NSRange] = []
repeat {
let textContainer = NSTextContainer(size: viewSize)
layoutManager.addTextContainer(textContainer)
// 不断创建 textView 让 NSLayoutManager 进行内容分页
let textView = UITextView(frame: textViewFrame, textContainer: textContainer)
textView.isEditable = false
textView.isSelectable = false
textView.textContainerInset = textInsets
textView.showsVerticalScrollIndicator = false
textView.showsHorizontalScrollIndicator = false
textView.isScrollEnabled = false // 禁止滑动, 否则计算结果将不再准确
textView.bounces = false
textView.bouncesZoom = false
// 获取当前分页内容所在位置
let range = layoutManager.glyphRange(for: textContainer)
ranges.append(range)
// 判定是否分页完成
glyphRange = NSMaxRange(range)
numberOfGlyphs = layoutManager.numberOfGlyphs
} while glyphRange < numberOfGlyphs - 1
CoreText 版本:
var ranges: [NSRange] = []
let framesetter = CTFramesetterCreateWithAttributedString(string)
var textPosition = 0
while textPosition < string.length {
let path = CGPath(rect: textViewFrame.inset(by: textInsets), transform: nil)
let frame = CTFramesetterCreateFrame(framesetter, .init(location: textPosition, length: 0), path, nil)
let stringRange = CTFrameGetVisibleStringRange(frame)
let range: NSRange = .init(location: stringRange.location, length: stringRange.length)
textPosition += stringRange.length
ranges.append(range)
}
至此, 就得到了带有格式的全文
NSAttributedString, 和分页区域的
ranges
第三步, 显示分页数据，小说系统源码的章节内容分页视图中, 将单章的
NSAttributedString 和分到的
range 分配给每一个单页显示视图, 在
UITextView 中直接设置
attributedText 为
attributedString.attributedSubstring(from: range)
UITextView 的设置务必于分页循环时的
UITextView 保持一致
声明：本文由云豹科技转发自Norld博客，如有侵权请联系作者删除
来自 “ ITPUB博客 ” ，链接：https://blog.itpub.net/70002045/viewspace-2845678/ ，如需转载，请注明出处，否则将追究法律责任。
