PDFKit开发：如何隐藏PDFView滚动指示器并修正横向滚动位置

问题根因 #

现有配置存在属性不匹配的问题，直接触发了内部布局计算异常：

• usePageViewController(true) 是为非连续的翻页交互设计的参数，和目标的横向连续单页滚动需求冲突
• 冲突会导致PDFView底层承载滚动能力的UIScrollView无法正确匹配自身bounds，最终横向滚动指示器脱离PDFView显示区域，露在屏幕底部的错位位置
• 这类错位属于布局计算问题，并非滚动逻辑本身的bug

实现方案 #

需求1：隐藏异常位置的滚动指示器 #

无需修改原有配置，直接通过遍历视图层级找到PDFView内部的滚动容器，关闭指示器显示即可：

• 遍历PDFView的一级子视图，定位到内置的UIScrollView实例
• 分别关闭横向、纵向滚动指示器的显示开关

for subview in pdfView.subviews {
    if let scrollView = subview as? UIScrollView {
        scrollView.showsHorizontalScrollIndicator = false
        scrollView.showsVerticalScrollIndicator = false
    }
}

• 注意：PDFView的子视图层级会在文档加载、模式切换时重建，这段查找设置的逻辑需要放在视图布局完成的时机（比如viewDidLayoutSubviews、PDF文档加载完成回调）执行，避免被系统重置回默认的指示器显示状态。

需求2：修正滚动位置，恢复正常布局下的滚动体验 #

移除冲突的配置参数，从根源解决布局异常：

• 删除和连续滚动模式不兼容的usePageViewController(true)配置行，修正后的基础配置为：

pdfView.autoScales = true
pdfView.displaysPageBreaks = true
pdfView.displayMode = .singlePageContinuous
pdfView.displayDirection = .horizontal
pdfView.minScaleFactor = 1
pdfView.document = pdfDocument

• 文档加载完成后，强制触发一次文档布局重置，把滚动偏移校正到正确起始位置：

// PDFDocument加载完成的回调内执行
pdfView.layoutDocumentView()
// 定位到文档第一页的初始位置
pdfView.goToFirstPage(nil)
// 等待一个布局周期后校正底层滚动视图的偏移
DispatchQueue.main.async {
    for subview in pdfView.subviews {
        if let scrollView = subview as? UIScrollView {
            scrollView.contentOffset = .zero
        }
    }
}

• 适配提醒：因为开启了autoScales自动缩放，当用户手动调整页面缩放比例、或者界面旋转尺寸变化时，需要重复执行上面的布局校正逻辑，避免滚动指示器再次出现错位。

踩坑提示 #

• 不要通过修改PDFView的背景色方式试图隐藏错位的指示器，错位元素属于PDFView内部的UIScrollView层级，修改PDFView本身的样式不会影响指示器的显示
• 如果确实需要保留分页翻页的交互效果，就不要搭配.singlePageContinuous连续滚动模式，对应翻页场景应该选择.singlePage（非连续）展示模式，否则一定会触发布局计算错误。

内容的提问来源于stack exchange，提问作者omshanti