当前位置：首页 > 全部内容 > JavaScript实现PDF标注扁平化：Dynamsoft Document Viewer操作指南

JavaScript实现PDF标注扁平化：Dynamsoft Document Viewer操作指南

作者：异步漫步时间：2026-10-31 18:00:01浏览：246

本文介绍如何使用Dynamsoft Document Viewer在JavaScript中实现PDF页面标注的扁平化处理。通过配置UI和调用相关API，开发者可以选择丢弃、合并为图像、扁平化或保留可编辑性四种模式，并深入解析PDF字典层面的实现原理，帮助开发者掌握PDF交互功能的集成方法。

首先，利用Dynamsoft Document Viewer打开目标PDF文件，并开启标注添加功能以准备后续操作。

  • 接下来，新建一个HTML文件，其中需包含特定的模板结构。
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
  <title>Burn PDF Annotation</title>
  <style>
  </style>
</head>
<body>
</body>
<script>
</script>
</html>
  • 在HTML页面中引入Dynamsoft Document Viewer的相关资源文件。
<script src="https://cdn.jsdelivr.net/npm/dynamsoft-document-viewer@2.1.0/dist/ddv.js"></script>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/dynamsoft-document-viewer@2.1.0/dist/ddv.css" rel="external nofollow" >
  • 通过提供有效的许可证来初始化Dynamsoft Document Viewer，用户可前往官方渠道申请证书。
Dynamsoft.DDV.Core.license = "DLS2eyJoYW5kc2hha2VDb2RlIjoiMjAwMDAxLTE2NDk4Mjk3OTI2MzUiLCJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSIsInNlc3Npb25QYXNzd29yZCI6IndTcGR6Vm05WDJrcEQ5YUoifQ=="; //one-day trial
Dynamsoft.DDV.Core.engineResourcePath = "https://cdn.jsdelivr.net/npm/dynamsoft-document-viewer@2.1.0/dist/engine";// Lead to a folder containing the distributed WASM files
await Dynamsoft.DDV.Core.init();
  • 实例化一个新的文档对象，作为后续操作的基础。
const docManager = Dynamsoft.DDV.documentManager;
const doc = docManager.createDocument();
  • 创建Edit Viewer实例并将其绑定至指定容器，用于展示前述创建的文档。其中的按钮配置可通过UIConfig对象进行设置，并需添加标注按钮以提供创建标注的操作入口。

HTML代码部分如下：

<div id="viewer"></div>

JavaScript逻辑代码如下：

Dynamsoft.DDV.setProcessingHandler("imageFilter", new Dynamsoft.DDV.ImageFilter());
let uiConfig = {
  type: "Layout",
  flexDirection: "column",
  className: "ddv-edit-viewer-desktop",
  children: [
    {
      type: "Layout",
      className: "ddv-edit-viewer-header-desktop",
      children: [
        {
          type: "Layout",
          children: [
            "ThumbnailSwitch",
            "FitMode",
            "DisplayMode",
            "RotateLeft",
            "Crop",
            "Filter",
            "Undo",
            "Redo",
            "DeleteCurrent",
            "DeleteAll",
            "Pan",
            "SeparatorLine",
            "AnnotationSet"
          ],
          enableScroll: true
        },
        {
          type: "Layout",
          children: [
            {
              "type": "Pagination",
              "className": "ddv-edit-viewer-pagination-desktop"
            },
            {
              type: Dynamsoft.DDV.Elements.Button,
              className: "ddv-button-download",
              events: {
                click: "exportPDFWithOptions",
              },
            },
          ]
        }
      ]
    },
    "MainView"
  ]
}
editViewer = new Dynamsoft.DDV.EditViewer({
  uiConfig: uiConfig,
  container: document.getElementById("viewer")
});

CSS样式代码如下：

#viewer {
  width: 320px;
  height: 480px;
}
  • 通过input元素选择图像或PDF文件，并将其加载至文档实例中。

对应的HTML代码如下：

<label>
  Select a file to load:
  <br/>
  <input type="file" id="files" name="files" onchange="filesSelected()"/>
</label>

相关的JavaScript代码如下：

async function filesSelected(){
  let filesInput = document.getElementById("files");
  let files = filesInput.files;
  if (files.length>0) {
    const file = files[0];
    const blob = await readFileAsBlob(file);
    await doc.loadSource(blob); // load the file
  }
}

function readFileAsBlob(file){
  return new Promise((resolve, reject) => {
    const fileReader = new FileReader();
    fileReader.onload = async function(e){
      const response = await fetch(e.target.result);
      const blob = await response.blob();
      resolve(blob);
    };
    fileReader.onerror = function () {
      reject('oops, something went wrong.');
    };
    fileReader.readAsDataURL(file);
  })
}

此时，界面将显示如下查看器效果：

首先，利用Dynamsoft Document Viewer打开目标PDF文件，并开启标注添加功能以准备后续操作。

完成标注后，需执行扁平化操作并保存PDF文件。

Dynamsoft Document Viewer提供了四种处理PDF标注的策略：

  • none：直接丢弃所有标注信息。
  • image：将所有内容合并至光栅图像中。
  • flatten：对所有标注执行扁平化处理。
  • annotation：以可编辑形式保存标注。需注意，被标记为扁平化的单个标注仍会被执行扁平化操作。

利用flatten选项保存PDF文件，即可实现所有标注的扁平化。

let blob = await doc.saveToPdf({
  saveAnnotation: "flatten"
})

若希望部分标注扁平化而保留其他标注的可编辑性，可设置标注的扁平化属性，并使用annotation选项保存PDF文件。

let annotations = Dynamsoft.DDV.annotationManager.getAnnotationsByDoc(doc.uid);
let annotation = annotations[0];
annotation.flattened = true;
let blob = await doc.saveToPdf({
  saveAnnotation: "annotation"
})

接下来探讨其内部运作机制。

PDF文件基于PostScript语言进行描述。以下通过示例展示扁平化过程中的内部操作细节。

PDF文件包含多个字典，以下为一个页面字典的示例结构。

4 0 obj
<<
  /Type/Page                 % Specifies that this dictionary defines a page.
  /Annots[ 8 0 R ]           % A list of references to annotation objects on this page.
  /Contents 7 0 R            % Reference to page content stream.
  /MediaBox[ 0 0 147 143.25] % Page dimensions.
  % Other page properties
>>
endobj
7 0 obj
<</Filter/FlateDecode/Length 44>>stream
x??41W0 BCc=#S039椝 ?J缫w媹0Tp蒞? 卵	
endstream
endobj

上述页面引用了相关的标注字典内容。

8 0 obj
<<
  /Type/Annot
  /AP<<
  /Contents(annotation)
    /CreationDate(D:20241227135119+08'00')
    /DA(0.9411764705882353 0.07450980392156863 0.0784313725490196 rg /Helvetica 16 Tf)
    /DS(font:  'Helvetica' 16pt; text-align:left; color:#F01314)
    /F 4
    /IT/FreeTextTypeWriter/M(D:20241227135125+08'00')/NM(m56c4eb9uq)/RC(<?xml version="1.0"?><body xmlns="http://www.w3.org/1999/xhtml" xmlns:xfa="http://www.xfa.org/schema/xfa-data/1.0/" xfa:APIVersion="Acrobat:18.11.0" xfa:spec="2.0.2" style="font-size:16pt;text-align:left;color:#f01314;font-weight:normal;font-style:normal;font-family:'Helvetica';font-stretch:normal;"><p dir="ltr"><span>annotation</span></p></body>)
    /Rect[ 22.1854 112.467 98.423 129.217]
    /Subj()
    /Subtype
    /FreeText
    /T()
>>
endobj

扁平化处理完成后，页面字典将更新为如下内容。此时不再包含标注节点，原标注节点的内容将转换为图形并附加至页面正文中。

4 0 obj
<<
  /Type/Page
  /Contents 13 0 R
  /MediaBox[ 0 0 147 143.25]
>>
endobj
7 0 obj
<</Filter/FlateDecode/Length 48>>stream
x???41W0 BCc=#S039椝 ?J缫w媹0Tp蒞溻
 靔	?
endstream
endobj
13 0 obj
[ 7 0 R  14 0 R ]
endobj
14 0 obj
<</Filter/FlateDecode/Length 29>>stream
x?T0T0 B櫆珷镦b犩挴 M+?
endstream
endobj

以上即为使用JavaScript将PDF页面中的标注扁平化的操作指南的详细内容，更多关于JavaScript PDF标注扁平化的资料请关注本站其它相关文章！

作者最新文章

JavaScript怎么遍历对象的Symbol键和不可枚举属性

2026-11-05 13:13:39

封装一个健壮的JS字符串判空工具函数

2026-11-05 12:16:14

JavaScript合并数组的三种常用方法：concat、扩展运算符与push

2026-11-05 11:22:29

JavaScript立即执行函数(IIFE)是什么及基本语法

2026-11-05 10:51:19

JS对象数组转字符串为什么推荐用JSON.stringify()

2026-11-05 09:40:31