WebSDK 记录并恢复 PDF 浏览位置与缩放比例

在 PDF 在线浏览场景中，用户常常需要临时离开当前阅读位置（如切换页面、跳转其他文档），返回时希望精准回到原位置并保持相同的缩放比例。本文将基于 PDF WebSDK，详细讲解如何实现 “记录当前浏览位置 + 缩放比例” 与 “精准恢复原位置” 的完整方案。

一、需求背景

在在线 PDF 阅读器、批注系统等业务场景中，用户操作过程中可能因查看其他内容、处理弹窗等操作离开当前阅读位置，手动找回原位置和缩放比例会降低体验。通过 WebSDK 提供的位置 / 缩放获取与设置 API，可自动记录并恢复用户的浏览状态，提升操作连贯性。

二、核心 API 说明

实现该功能依赖 PDF WebSDK 的两个核心 API，先明确关键接口的作用：

API	作用
pdfui.getPDFDocRender()	获取 PDF 文档渲染实例，用于后续位置 / 缩放操作
docrender.getOffsetInfo()	获取当前文档的浏览信息，包含页码、坐标、缩放比例等核心参数
pdfui.zoomTo(scale)	设置 PDF 的缩放比例
docrender.goToPage(index, {x,y}, true)	跳转到指定页码的指定坐标位置，第三个参数true表示精准定位

三、完整实现代码 KB

以下是封装后的可直接复用代码，包含 “记录状态”“恢复状态” 两个核心函数，以及异常处理、边界校验等完善逻辑：

//记录当前位置
var docrender = await pdfui.getPDFDocRender()
var pos = await docrender.getOffsetInfo()
//回跳到具体位置
await pdfui.zoomTo(pos.scale)
await docrender.goToPage(pos.index,{x:pos.left,y:pos.top},true)

一、需求背景

二、核心 API 说明

三、完整实现代码 KB

PDF WebSDK 实战：限制某一种注释仅可移动不可调整大小

如何取消WebSDK注释中“设置当前属性为默认”的操作

如何高亮表单域、自定义表单域颜色以及重置表单？

文档中的文字变的不光滑，而是锯齿形状，怎么能调整回来呢？

图片型表格如何转为可编辑的Excel?

如何将表单数据导出和导入？

如何把word/Excel中的表格做成表单？

如何在PDF中根据表单内容生成二维码？

为什么从其他pdf文件复制过来的文本和图片都无法编辑？

如何添加音视频并使用呢？