Native XFA Scalar Value Properties

De event-host creëert echte native formulier-waarde-containers en scalar-bladeren via property-toegang of getElement; veld-waarde-properties, gebonden datawaarden en widget-reads delen dezelfde huidige waarde

Scalar-creatie

De ondersteunde scalar-kinderen zijn boolean, date, dateTime, decimal, float, integer, text en time, met één occurrence van één gekozen waardeklasse

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

Een ontbrekende scalar-property lezen materialiseert diens native formulier-node en initialiseert diens content vanuit de huidige effectieve waarde van het veld; herhaalde toegang geeft hetzelfde live property-object terug

Value heeft gewone prototype-attributes, override=0 en standaard een leeg relevant-attribute; ondersteunde scalar-klassen leggen gewone prototype-attributes en een lege naam bloot

De one-of-check omvat alle standaard waardekeuzes, dus een scalar kan niet naast een bestaande image-, exData- of graphic-waardekeuze worden aangemaakt

Directe en native synchronisatie

Scalar-blad-value- en rawValue-accessors proxien het bezittende veld; gebonden dataValue.value is een schrijfbare alias van diens rawValue-accessor

Veld-, scalar- en data-writes werken elkaar diens reads bij tijdens hetzelfde script, inclusief andere velden die dezelfde gebonden datawaarde delen

Native publicatie werkt de datasetwaarde en bestaande gematerialiseerde scalar-formulierbladeren bij; interactieve widget-commits en berekeningsresultaten synchroniseren ook gematerialiseerde value-properties voor gebonden velden, inclusief verborgen en onzichtbare aliassen

Getypeerde scalar-content wordt als meegeleverde tekst vastgehouden, inclusief canonieke datum-, tijd- en numerieke strings; deze fase introduceert geen automatische numerieke coercie of nieuwe picture-formatting

Verborgen alias-synchronisatie volgt echte herhaalde data-scopes en behoudt niet-gematerialiseerde properties

Instances, identiteit en transacties

Een value-property in één herhaalde occurrence creëren en bewerken behoudt de andere occurrences; script-objecten kunnen een scalar-property-referentie vasthouden voor een later event

Nieuwe herhaalde instances ontvangen onafhankelijke native value-nodes; data-writes naar een nieuw aangemaakte instance werken diens echte gematerialiseerde scalar-blad bij voordat de transactie wordt opgeslagen

Enginefouten, native waardebudget-falen en conflicterende waardekeuzes herstellen exacte native XDP-bytes, inclusief velddata, gematerialiseerde waardebladeren en gedeelde aliassen

Native synchronisatiescans doen mee aan de event operation- en elapsed-time-budgetten; excessief werk verwerpt de transactie en herstelt diens snapshot

Opgeslagen PDF-uitvoer

XFA AcroForm-conversie consumeert de gepersisteerde scalar-waarden voor native veldwaarden en gegenereerde appearances; herhaalde eerste-instance-waarden blijven ongewijzigd

De gerichte opgeslagen producer heropent de native XDP vóór conversie, en onafhankelijke pypdf- en MuPDF-checks inspecteren getypeerde formulierbladeren, datasetwaarden, native velden en echte zichtbare appearance-tekst

Resterende integratiedoelen

Native exData XML ondersteunt afwezige waarde-creatie, echte foreign XML-import, directe script-serialisatie en gepersisteerde rich-draw-consumptie

Draw- en caption-scalar-consumers ondersteunen aangemaakte per-instance waarden en expliciet lege overrides

Image- en graphic-waarde-creatie ondersteunt native image-, boog-, lijn- en rechthoek-kinderen met echte draw-consumers