Native XFA Scalar Value Properties

Event-hosten opretter rigtige native formularværdi-containere og scalar-blade gennem property-adgang eller getElement; feltværdiproperties, bundne dataværdier og widget-læsninger deler samme aktuelle værdi

Scalar-oprettelse

De understøttede scalar-børn er boolean, date, dateTime, decimal, float, integer, text og time med én occurrence af én valgt værdiklasse

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

Læsning af en manglende scalar-property materialiserer dens native formularnode og initialiserer dens indhold fra feltets aktuelle effektive værdi; gentagen adgang returnerer samme live property-objekt

Value har fælles prototype-attributter, override=0 og en tom relevant attribut som standard; understøttede scalar-klasser udstiller fælles prototype-attributter og et tomt navn

One-of-tjekket inkluderer alle standard value-valg, så en scalar ikke kan oprettes ved siden af en eksisterende image-, exData- eller grafikværdi-valg

Øjeblikkelig og native synkronisering

Scalar blad value- og rawValue-accessors proxyer det eende felt; bundet dataValue.value er en skrivbar alias af dets rawValue-accessor

Felt-, scalar- og dataskrivninger opdaterer hinandens læsninger under samme script, inklusive andre felter, der deler samme bundne dataværdi

Native publicering opdaterer datasetværdien og eksisterende materialiserede scalar formularblade; interaktive widget-commits og beregningsresultater synkroniserer også materialiserede værdiproperties for bundne felter, inklusive skjulte og usynlige aliasser

Typet scalar-indhold tilbageholdes som leveret tekst, inklusive kanoniske dato-, tids- og numeriske strenge; denne fase introducerer ikke automatisk numerisk tvang eller ny picture-formatering

Skjult alias-synkronisering følger faktiske gentagne data-scopes og bevarer umaterialiserede properties

Instances, identitet og transaktioner

At oprette og redigere en værdiproperty i én gentaget occurrence bevarer de andre occurrences; script-objekter kan tilbageholde en scalar property-reference til et senere event

Nye gentagne instances modtager uafhængige native værdinoder; dataskrivninger til en nyligt oprettet instance opdaterer dens faktisk materialiserede scalar-blad, før transaktionen gemmes

Motorfejl, native værdibudget-fejl og modstridende value-valg gendanner eksakte native XDP-bytes, inklusive feltdata, materialiserede værdiblade og delte aliasser

Native synkroniseringsscanninger deltager i eventets operations- og forløbet-tidsbudgetter; overdrevent arbejde afviser transaktionen og gendanner dens snapshot

Gemt PDF-output

XFA AcroForm-konvertering forbruger de persisterede scalar-værdier til native feltværdier og genererede appearances; gentagne første-instance-værdier forbliver uændret

Den fokuserede gemte producent genåbner native XDP inden konvertering, og uafhængige pypdf- og MuPDF-tjek inspicerer typede formulablade, datasetværdier, native felter og faktisk synlig appearance-tekst

Tilbageværende integrationsmål

Native exData XML understøtter fraværende værdioprettelse, rigtig fremmed XML-import, øjeblikkelig script-serialisering og persisteret rich draw-forbrug

Draw- og caption scalar-consumers understøtter oprettede per-instance værdier og eksplicitte tomme overrides

Billed- og grafikværdioprettelse understøtter native billed-, bue-, linje- og rektangelbørn med rigtige draw-consumers

Komplet scalar-formatvalidering, rich widget-appearances og Unicode appearance-indlejring forbliver separate implementeringsmål

Relaterede API'er

Native Data DOM, Native feltstandarder, Absent Property Creation og Interactive XFA Runtime