Native XFA Scalar-Value-Properties

Der Ereignis-Host erzeugt echte native Formular-Value-Container und skalare Blätter über Property-Zugriff oder getElement; Feld-Value-Properties, gebundene Datenwerte und Widget-Lesezugriffe teilen sich denselben aktuellen Wert

Scalar-Erzeugung

Die unterstützten skalaren Kinder sind boolean, date, dateTime, decimal, float, integer, text und time, mit einem Vorkommen einer ausgewählten Value-Klasse

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");

Das Lesen einer fehlenden skalaren Property materialisiert ihren nativen Formularknoten und initialisiert ihren Inhalt aus dem aktuellen effektiven Wert des Felds; wiederholter Zugriff liefert dasselbe Live-Property-Objekt

Value hat standardmäßig gängige Prototyp-Attribute, override=0 und ein leeres relevant-Attribut; unterstützte skalare Klassen legen gängige Prototyp-Attribute und einen leeren Namen offen

Die one-of-Prüfung umfasst alle Standard-Value-Optionen, sodass kein skalarer Wert neben einer bestehenden image-, exData- oder grafischen Value-Option erzeugt werden kann

Sofortige und native Synchronisation

Skalare Blatt-value- und rawValue-Accessoren proxen das besitzende Feld; gebundenes dataValue.value ist ein schreibbarer Alias seines rawValue-Accessors

Feld-, Scalar- und Daten-Schreibzugriffe aktualisieren gegenseitig ihre Lesezugriffe im selben Skript, einschließlich anderer Felder, die denselben gebundenen Datenwert teilen

Die native Veröffentlichung aktualisiert den Dataset-Wert und bestehende materialisierte skalare Formularblätter; interaktive Widget-Commits und Berechnungsergebnisse synchronisieren ebenfalls materialisierte Value-Properties für gebundene Felder, einschließlich versteckter und unsichtbarer Aliases

Typisierter skalarer Inhalt bleibt als gelieferter Text erhalten, einschließlich kanonischer Date-, Time- und numerischer Strings; diese Stufe führt keine automatische numerische Koersion oder neue Picture-Formatierung ein

Die verdeckte Alias-Synchronisation folgt tatsächlichen wiederholten Daten-Scopes und bewahrt unmaterialisierte Properties

Instanzen, Identität und Transaktionen

Das Erzeugen und Bearbeiten einer Value-Property in einem wiederholten Vorkommen bewahrt die anderen Vorkommen; Skriptobjekte können eine skalare Property-Referenz für ein späteres Ereignis behalten

Neue wiederholte Instanzen erhalten unabhängige native Value-Knoten; Daten-Schreibzugriffe auf eine neu erzeugte Instanz aktualisieren ihr tatsächliches materialisiertes skalares Blatt, bevor die Transaktion gespeichert wird

Engine-Fehler, native Wertbudget-Fehler und konfligierende Value-Optionen stellen exakte native XDP-Bytes wieder her, einschließlich Felddaten, materialisierter Value-Blätter und geteilter Aliases

Native Synchronisations-Scans beteiligen sich an den Ereignis-Operations- und Ablaufzeit-Budgets; übermäßige Arbeit verwirft die Transaktion und stellt ihren Snapshot wieder her

Gespeicherter PDF-Output

Die XFA-AcroForm-Konvertierung konsumiert die persistierten skalaren Werte für native Feldwerte und erzeugte Appearances; wiederholte Erstinstanz-Werte bleiben unverändert

Der fokussierte gespeicherte Producer öffnet das native XDP vor der Konvertierung erneut, und unabhängige pypdf- und MuPDF-Prüfungen inspizieren typisierte Formularblätter, Dataset-Werte, native Felder und tatsächlichen sichtbaren Appearance-Text

Verbleibende Integrationsziele

Natives exData-XML unterstützt die Erzeugung fehlender Werte, echten Fremd-XML-Import, sofortige Skriptserialisierung und persistierten Rich-Draw-Verbrauch

Draw- und Caption-Scalar-Consumer unterstützen erzeugte Instanz-Werte und explizite leere Override

Bild- und Grafikwert-Erzeugung unterstützt native image-, arc-, line- und rectangle-Kinder mit echten Draw-Consumern