WebSDK 表单修改事件监听（onDataChanged）

概述

在 PDF WebSDK 中，FormFillerService 提供了 onDataChanged 事件，用于实时监听 PDF 表单字段的数据变更。当用户在表单控件中修改内容（输入文本、勾选复选框、选择下拉项等）时，SDK 会自动触发该事件，回调中携带：

当前 PDF 文档对象
被修改的 Widget 标识（页索引 + 对象编号）

开发者可以在回调中获取具体的注释（Annotation）、表单字段（Field）及其最新值，实现数据同步、自动保存、表单校验等业务逻辑。

参考代码

// 1. 获取 PDFViewer 和当前文档
var pdfViewer = await pdfui.getPDFViewer();
var doc = await pdfui.getCurrentPDFDoc();

// 2. 获取表单服务实例
var service = await pdfViewer.getFormFillerService();

// 3. 注册表单数据变更监听
service.onDataChanged(async (doc, widgetId) => {
    // widgetId 包含：
    //   widgetId.pageIndex  — 所在页索引（从 0 开始）
    //   widgetId.objNumber  — 注释对象的编号

    console.log(
        "文档: " + doc.info.fileName +
        "  页码: " + widgetId.pageIndex +
        "  对象编号: " + widgetId.objNumber
    );

    // 4. 根据页索引获取 Page
    var page = await doc.getPageByIndex(widgetId.pageIndex);

    // 5. 根据对象编号获取注释（Annotation）
    var annots = await page.getAnnotsByObjectNumArray([widgetId.objNumber]);
    console.log("Annotation:", annots[0]);

    // 6. 获取表单字段及其当前值
    var field = annots[0].getField();
    var value = await field.getValue();
    console.log("字段值:", value);
});

console.log("onDataChanged 事件注册成功。");

概述

参考代码

多份PDF文档批量打印不同份数？福昕来帮你！

在线批注PDF后，如何将不带注释数据的文件流回传服务器？

在福昕高级PDF编辑器中如设置常用图章

在福昕高级PDF编辑器中如何将鼠标滚轮为缩放操作

粘贴图像到PDF文件

取消增强细线选项解决字体毛刺现象

32位电脑安装64位安装包报错提示

如何设置启动软件启动时开启上一次会话

选择文本或图像时不显示浮动工具条该如何处理

如何通过裁剪页功能调整页面留白