福昕开发者文档中心

福昕 PDF SDK (Web 版) 11.1.0 ​

发布日期：2026 年 4 月 20 日

更新说明 ​

本版本在书签、文本提取、注释、表单、签名、三维与测量及 Viewer 集成 等方面提供 17 项能力增强，并包含 60 项客户报告的问题修复。若从 11.0 升级，请先阅读下方 「重大变更」 中关于 书签 的说明。

重大变更 ​

书签 — 异步目的地（不兼容变更） ​

变更说明

  • 自 11.1.0 起，BookmarkData 上的 page、left、top、zoomMode、zoomFactor 已标记为 弃用。为提升大型及线性化 / 分片加载 PDF 的性能，书签树初始节点不再内嵌完整目的地数据。

请改用

  • BookmarkDataService.getBookmarkDestination(bookmarkId) — 异步获取目的地数据（坐标、缩放及相关字段），用于缩略图、叠加层或自定义滚动逻辑。
  • BookmarkDataService.performAction(bookmarkId) — 执行书签绑定的 PDF 动作链（GoTo、URI、JavaScript 等），行为与内置书签面板一致；标准跳转场景下 无需 在 performAction 之前调用 getBookmarkDestination。
  • 书签与页面关联时，宜优先使用 页面对象号（page object number），避免仅依赖易变的 pageIndex。

新增功能与增强项 ​

页面文本与高级编辑 ​

  • PDFPage：新增 getText、getCharCount、getCharInfoByIndex、getCharRange，便于实现依赖 字符索引 的集成场景（如校对、批注锚点及与检索类 API 联动的自动化）。
  • PDFPage.addRichText：可在页面上以程序方式写入富文本（需 AdvEdit 授权）。

注释与表单 ​

  • PDFViewer.setMultipleSelectionEnabled / isMultipleSelectionEnabled：可开启或关闭选框（矩形拖动）多选、Ctrl/Shift 键多选，以及注释与表单域的 Ctrl+A / Cmd+A 全选。
  • PDFPage.setAnnotGroup 与 MarkupAnnot.ungroup：在 不新建 PDF 对象的前提下成组或解组，objNumber、name 保持稳定；成组相关 UI 请监听 annotationUpdated 中的 AnnotUpdatedType.groupUpdated。
  • enableRealtimeAnnotShapeUpdate（开/关）：拖动或缩放过程中可选地实时刷新 标注形状；可通过 PDFViewer 构造参数 和/或运行时 pdfViewer.config.enableRealtimeAnnotShapeUpdate 配置。
  • AnnotComponentConfig.enableDiagonally：在注释组件配置回调中为 Callout 提供对角缩放控制点。
  • FreeText：混排与版式下编辑表现更接近 福昕 PDF 编辑器（桌面版）。
  • 表单按钮：新增 「选择图标」 对话框，支持浏览、预览及 清除 按钮使用的图片（JPEG、PNG、GIF、BMP）。

签名与图章 ​

  • 快速签名（位于 保护 菜单）：可在页面上以 PSI 笔迹模拟压感效果，与经典 PDF 签名 对话框绘制并存。
  • 签名相关界面：支持在右键菜单 清除签名；保护 菜单下 签署与认证 提供 放置签名；PDFDoc.sign 扩展 isKeepRatio、custom 位图叠加以定制外观。
  • 自定义动态图章：界面与 API（CustomDynamicStamp / setDynamicStamp，field 可为对象或数组）支持多段标签配置。

三维与测量 ​

  • 三维 PDF：侧栏提供 模型树（部件显隐控制）及带预设相机的 视图列表，便于设计评审类导航。
  • CreateMeasurementService（通过 pdfViewer.getCreateMeasurementService() 获取）：可对测量创建流程进行程序化配置（如是否生成测量注释、标签、结果面板显隐、捕捉模式、比例尺等），以正式 API 取代对测量侧栏未公开 DOM 的临时耦合。

宿主集成 ​

  • PDFViewer 构造函数：支持 customs.containerRoot（HTMLElement），在未使用 iframe 嵌入时限定样式作用域（可与 Shadow DOM 等模式配合）。
  • 稳定的 component-name 属性：注释菜单及相关组件名称规范化，便于通过 getComponentByName 做可预期的二次开发。

性能优化 ​

  • 书签：异步 getBookmarkDestination 及更精简的初始树，减少打开或展开书签树时的前期解析与计算量，改善大型线性化文档及 openPDFByHttpRangeRequest 场景下书签面板的响应。
  • 渲染： 显著优化了渲染流水线，缩放交互提速最高达 39%，注释与表单翻页提速高达 34%。

问题修复 ​

渲染 ​

  • 修复 SDK 11 中 page.render 导出位图为黑底，与 10.x 白底表现不一致的问题。
  • 【性能】 修复大批量 page.render 转图过程中间页触发 getPageBitmap 引擎报错中断的问题。
  • 【性能】 修复大型图纸在移动端内存过高或崩溃、桌面端内存与渲染卡顿等问题。
  • 修复缩放过程中注释与控制框短时不同步、出现「漂移 / 卡针」观感的问题。
  • 修复手机端双指缩放松手后偶发整页位移的问题。
  • 【性能】 修复 Safari 下滚动卡顿、侧栏影响首屏与跳转，以及 wheel 监听非 passive 引发性能告警等问题。
  • 【性能】 改进 PDF 缩放过程中 Stamp 闪烁的渲染体验。
  • 【性能】 改进大文档在视图旋转后连续滚动时的渲染速度。

文档与页面 ​

  • 修复先 loadPDFDocByHttpRangeRequest 再带分片 openPDFByHttpRangeRequest 打开时界面空白或提示文件损坏的问题。
  • 修复协作场景下首位用户关闭协同页后，其他用户同会话 URL 内注释未同步或丢失的问题。
  • 【性能】 修复 getEmbeddedFile 提取大体积内嵌附件耗时过长及超大附件导致浏览器崩溃的问题。
  • 修复 openPDFByHttpRangeRequest 打开特定 PDF 时第二页显示为虚拟空白页及首页交互报 Unknown engine error 的问题。

文本与内容 ​

  • 修复 compareDocuments 在越南语（vi-VN）词条下输出对比结果 PDF 时摘要或结果标题等文本丢失的问题。
  • 修复大页数 PDF 上 PDFDoc.searchText 正则检索（Search & Redact）失败的问题。
  • 修复高级编辑文本模式下日语输入法输入全角括号后选区异常无法取消的问题。
  • 修复搜索与手动涂黑交替后，按搜索结果标记密文时选区偏移（文本索引未随删文更新）的问题。

表单与 XFA ​

  • 修复表单域「创建多个副本」纵向、横向数量与 10.x 及桌面 Editor 逻辑相反的问题。
  • 修复动态 XFA 表单导出 XML 再导入后字段值无法写回的问题。
  • 修复手型工具点击表单域仍触发 activeAnnotation 事件的问题。
  • 修复 GDOR 税务样表中关闭帮助弹窗内存错误、Tab 键误用于换页、日期控件面板不自动收起等问题。

注释 — 交互、显示与权限 ​

  • 修复特定文档上 Callout 无法在页面左侧放置、连续创建时引线或文本框异常或塌陷的问题。
  • 修复使用自定义映射字体时，注释在编辑失焦前后行距或末行显示不一致的问题。
  • 修复高缩放且页面超出视口时，FreeText 持续输入后文本框宽度异常变窄的问题。
  • 修复移动端先打开单页再切换多页文档后无法纵向滑动翻页的问题。
  • 修复未结束 Typewriter 编辑即滚轮跨页连续输入时，注释列表中部分页注释缺失的问题。
  • 修复 setDefaultAnnotConfig 对 Note 等注释默认颜色或属性不生效的问题。
  • 修复部分绘制路径下 Callout 默认矩形过大、引线起点与鼠标不符的问题。
  • 修复鼠标悬停于已有注释上偶发运行时错误（与重载文档、控制台开关等相关复现路径）的问题。
  • 修复仅授予删除权限时，仍可通过右键对齐、分布、统一大小等菜单移动注释的问题。
  • 修复打开特定文档时注释加载数量少于 Adobe，并伴随 getAnnots 引擎报错的问题。
  • 修复测量类注释默认仍具备修改几何（rect）权限的问题。
  • 修复设置 Stamp 默认属性后，在旋转页创建再拖至普通页出现压扁或缩放异常的问题。
  • 修复区域高亮无法叠画在 TextBox 或 Callout 之上、与桌面 Editor 视觉层级不一致的问题。
  • 修复程序化设置测量比例尺单位时标尺单位界面闪烁的问题。
  • 修复通过 annotComponent.active() 或 pdfui.activateElement 激活注释时不触发 activeAnnotation 的问题。
  • 修复首次程序化添加 Stamp 时矩形与图章宽高或坐标不符、切换文档后表现异常的问题。
  • 修复云线（Cloud）注释弧段在部分绘制方向朝外、未始终朝向内侧的问题。
  • 修复自定义图章下拉项 title 或 tooltip 显示分类名而非图章名的回归问题。
  • 修复新建自定义动态图章后，从手型切换到该图章工具报错的问题。
  • 修复快速点击注释并立即移开鼠标时选中错误注释或无法选中的问题。
  • 修复 Chromium 86 内核（如 360 企业浏览器）上铅笔或打字机注释异常、控制台报错及翻页残留等问题。

注释 — 数据交换 ​

  • 修复高亮注释导出 JSON 再导入后被自动贴附文本、与导出前独立区域高亮不一致的问题。
  • 修复特定文档导入注释无响应或页面空白的问题。
  • 修复旋转页上 Typewriter 导出 JSON 再导入后排版与导出前不一致的问题。
  • 修复导入 PDFBox 导出 FDF 后文本替换（caret）类注释显示不完整的问题。
  • 修复注释 JSON 导出再导入后不间断空格（U+00A0）被显示为欧元符号等问题。
  • 修复特定文档通过接口或 UI 将注释导出为 JSON 时报错的问题。
  • 修复 XFDF 导出中页面旋转相关属性名与历史版本及常见互操作（rotation / rotate）不一致导致解析偏差的问题。
  • 修复注释 JSON 中 content 以反斜杠结尾等转义不当导致整批导入失败的问题。

注释 — 组合 ​

  • 修复组合注释后拉伸单个成员导致组内其他成员位置被连带偏移的问题。
  • 修复组合注释后 setBorderWidth 仅作用于当前成员、与同组其他边框 API 行为不一致的问题。
  • 修复组合或多选注释时 annotationUpdated 对移动或线宽等操作触发次数不稳定或重复触发的问题。
  • 修复组合注释后 setBorderInfo 仅作用于单个成员，而 setBorderStyle / setBorderWidth 整组生效的行为不一致问题。
  • 修复偶现组合注释移动或改属性后画布未刷新、需滚动页面后才与模型一致的问题。

安全与签名 ​

  • 修复空文档添加并删除 Stamp 后保存体积异常膨胀的问题。
  • 修复签名域位于页面左半区时，签名完成后再次打开文档视口被错误下滚的问题。
  • 修复自定义动态图章在列表刷新后出现缝隙、与初次无缝展示不一致的问题。
  • 修复仅打开并通过 SDK 下载即改变 Note 弹出图标可见性、与桌面 Editor 偏好不一致的问题。

其他 ​

  • 修复 Next.js 12 工程集成官方示例时无法正确加载 SDK 的问题（与 Next 14 示例行为对齐）。
  • 修复 pdfViewer.offShortcutKey('ctrl+v') 无法禁用粘贴快捷键的问题。