ネイティブ XFA スカラー値プロパティ

イベントホストは、プロパティアクセスか getElement を通じて実際のネイティブフォーム値コンテナとスカラーリーフを作成します。フィールド値プロパティ、バインド済みデータ値、ウィジェット読み取りは同じ現在値を共有します

スカラー作成

サポート対象のスカラーの子は boolean、date、dateTime、decimal、float、integer、text、time で、選択した 1 つの値クラスの出現 1 つを持ちます

const field = xfa.form.resolveNode("main.row[1].input");
const leaf = field.value.getElement("text", 0);
leaf.value = "updated";
field.dataNode.value = "from-data";
if (leaf.value !== "from-data") throw new Error("Value synchronization failed");

存在しないスカラープロパティの読み取りはネイティブフォームノードを実体化し、その内容をフィールドの現在の実効値から初期化します。繰り返しアクセスは同じライブプロパティオブジェクトを返します

value は既定で共通のプロトタイプ属性、override=0、空の relevant 属性を持ちます。サポート対象のスカラークラスは共通のプロトタイプ属性と空の name を公開します

one-of 検査は標準の値選択肢すべてを含むため、既存の image、exData、graphic の値選択の横にスカラーを作ることはできません

即時かつネイティブな同期

スカラーリーフの value と rawValue アクセッサは所有フィールドへのプロキシです。バインド済み dataValue.value はその rawValue アクセッサの書き込み可能なエイリアスです

フィールド、スカラー、データの書き込みは同じスクリプト内でお互いの読み取りを更新します。同じバインド済みデータ値を共有する他のフィールドも含みます

ネイティブ公開は datasets の値と既存の実体化済みスカラーフォームリーフを更新します。インタラクティブなウィジェットコミットと計算結果も、hidden や invisible のエイリアスを含むバインド済みフィールドの実体化済み値プロパティを同期します

型付きスカラーコンテンツは、正規の日付・時刻・数値文字列も含めて供給テキストのまま保持されます。この段階で自動的な数値型強制や新しいピクチャ書式は導入されません

隠蔽エイリアスの同期は実際の繰り返しデータスコープに従い、未実体化のプロパティを保持します

インスタンス、識別子、トランザクション

ある繰り返し出現で値プロパティを作成・編集しても他の出現は保たれます。スクリプトオブジェクトは後のイベントのためにスカラープロパティ参照を保持できます

新しい繰り返しインスタンスは独立したネイティブ値ノードを受け取ります。新規作成インスタンスへのデータ書き込みは、トランザクション保存前に実際の実体化済みスカラーリーフを更新します

エンジンエラー、ネイティブ値予算の失敗、競合する値の選択は、正確なネイティブ XDP バイトを復元します。フィールドデータ、実体化済み値リーフ、共有エイリアスも含みます

ネイティブ同期スキャンはイベントの操作予算と経過時間予算に参加します。過剰な作業はトランザクションを棄却し、スナップショットを復元します

保存 PDF 出力

XFA AcroForm 変換は、永続化されたスカラー値をネイティブフィールド値と生成アピアランスに消費します。繰り返しの最初のインスタンス値は変更されません

焦点を当てた保存プロデューサーは変換前にネイティブ XDP を開き直し、独立した pypdf と MuPDF の検査が、型付きフォームリーフ、datasets 値、ネイティブフィールド、実際の可視アピアランステキストを調べます

残る統合対象

ネイティブ exData XML は、存在しない値の作成、実際の外部 XML インポート、即時のスクリプトシリアライズ、永続化されたリッチ draw 消費に対応します

draw と caption のスカラーコンシューマは、作成されたインスタンスごとの値と明示的な空の上書きに対応します

画像とグラフィック値の作成は、実際の draw コンシューマを持つネイティブな image、arc、line、rectangle の子に対応します