原生 XFA Draw 与 Caption 值
扁平化与 AcroForm 消费方读取已物化的按实例标量值(用于 draw 与 pushbutton caption),包括模板没有值容器时创建的值
创建与修改内容
const row = xfa.form.resolveNode("main.row[1]");
row.label.value.text.value = "Visible draw";
row.button.caption.value.text.value = "Visible caption";
row.label.value.text.value = "";
受支持的标量类别为 boolean、date、dateTime、decimal、float、integer、text 与 time;draw 内容保留 supplied 文本,不做数值强转或新 picture 格式化
既有模板标量值可接收原生表单覆写;缺失的值在选定的原生表单实例中创建
重复的首实例保留原内容;新增重复实例获得独立的 draw 与 caption 值,并在原生 XDP 重载后存续
显式空值
显式空 draw 覆写会抑制模板文本,而不是恢复它
显式空 caption 保持空白;没有标量 caption 内容的按钮保留字段名回退
保存的空白 caption 可以省略原生 PDF caption 条目,其真实外观不保留任何标签文本
持久化与回滚
标量创建与内容写入持久化真实原生表单节点;保存 PDF 的生产者在生成 PDF 之前重载原生 XDP
聚焦验收针对初始创建、显式清空与新增重复实例,检查原生 XDP 叶节点、真实 PDF caption 与外观算子以及可见 MuPDF 文本
脚本失败与原生内容预算失败都按字节精确还原原生 XDP,包括后继 draw 变更失败之前已应用的 caption 变更