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

在执行文件打印时如何将默认的打印数量设置为1

在合并文件时如何统一设置页面大小

文件每次打开时缩放比例都是200%如何将缩放比例调整为100%

如何查看查看PDF/A的版本信息

如何使用电子签章对内签署

电子签章签署后如何查看相关签署记录

电子签章对外签署如何在软件上实现签署时自动添加签署日期

电子签章对外签署如何在软件上分配印章使用权

电子签章对外签署如何邀请他人签署

电子签章对外签署如何实现签署时自动添加签署日期