原生 XFA Draw 與 Caption 值
壓平與 AcroForm 消費端讀取已實體化的逐 instance scalar 值(draw 與 push button caption),包括 template 沒有值容器時建立的值
建立與變更內容
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 = "";
支援的 scalar 類別為 boolean、date、dateTime、decimal、float、integer、text 與 time;draw 內容保留 supplied 文字,不做數值強制轉換,也不套用新的 picture 格式
既有 template scalar 值可接受原生表單覆寫,缺席的值則在選定的原生表單 occurrence 中建立
重複的第一個 occurrence 保留原始內容;新增的重複 instance 取得獨立的 draw 與 caption 值,並在原生 XDP 重新載入後存活
明確空值
明確的空 draw 覆寫會抑制 template 文字,而不是恢復它
明確的空 caption 保持空白;沒有 scalar caption 內容的按鈕保留欄位名稱 fallback
儲存的空白 caption 可能省略原生 PDF caption 條目,其實際外觀不含任何標籤文字
持久化與 rollback
scalar 建立與內容寫入持久化實際的原生表單節點;已存 PDF 產生器在產生 PDF 之前重新載入原生 XDP
聚焦的驗收檢查初始建立、明確清空與新增重複 instance 的原生 XDP 葉節點、實際 PDF caption 與外觀運算子,以及可見 MuPDF 文字
script 失敗與原生內容預算失敗會逐位元組還原原生 XDP,包括在後續 draw 變更失敗之前已套用的 caption 變更