Component
De eenheid van UI, een elementenboom gekoppeld aan lokale status, data en de workflowlogica die alles verbindt.
Een Component is een UI-eenheid: een elementenboom gekoppeld aan lokale status, optionele data, lifecycle-logica en een invoer- en uitvoerinterface. Een pagina, een kaart, een modal, een popover, een inline fragment: het zijn allemaal Components. Het is het rijkste documenttype van het platform, met een eigen UI-boom naast de velden, events en datasource die elk programmatype deelt.
Eigenschappen
renderType (form / grid / list) is deprecated en niet meer nodig. Nieuwe components worden zonder aangemaakt. Wat een nieuwe Component wel krijgt, is een scaffold-keuze, single of multi, die je één keer maakt in het dialoogvenster Nieuwe Component: single zet een kale xu-template-root neer waarin je direct kunt bouwen, multi zet dezelfde xu-template-root neer met een laad-div en een xu-multi-view er al in genest. xu-single-view is nog steeds een echte tag die je zelf kunt gebruiken, alleen plaatst de factory hem niet voor je: alleen een niet-gemigreerd verouderd document (root nog geen xu-template) wordt ertegen gecontroleerd, wanneer de verouderde renderType nog form zegt.
progUi, de elementenboom
De rootnode is altijd een transparante xu-template, aangemaakt door scaffold_prog_ui van create_prog. Met de multi-scaffold worden een laad-div en een xu-multi-view voor je in de root genest. De single-scaffold laat hem leeg, bouw dan direct in zijn children. Elke node heeft een unieke id, type: "element", een tagName, en attributes: {} en children: [], ook als ze leeg zijn.
Naast gewone HTML-tags worden enkele xuda-tags direct gebruikt: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.
Een tagName met een hoofdletter (Button, Dialog) wordt altijd opgevat als een gecompileerde designsysteem-component, nooit als HTML-element, ook als het een typfout is: dan volgt er een fout bij het mounten, met de tag en elke geprobeerde bron erbij. De gewone attributen worden props, geen DOM-attributen (variant, color, class komen allemaal aan als props.<name>) en anders dan xu-panel heeft zo'n tag geen out-params: een componenttag leest alleen wat je meegeeft.
Dynamisch gedrag: xu-*-attributen
Elk xu-*-attribuut dat de elementenboom van een Component kan hebben:
Twee zijn makkelijk te verwisselen: xu-bind neemt de kale veld-id, zonder @, de enige uitzondering op de @-regel die overal elders geldt. En xu-exp:class vervangt het statische class-attribuut helemaal, dus layoutklassen moeten in de expressie worden herhaald.
progFields, progEvents, progDataSource
Lokale status (progFields, virtual of gekoppeld aan een table), een optionele ingebedde Datasource en lifecycle-events. Drie van die events verdelen het werk op een manier die makkelijk door elkaar te halen is:
Als je verversingswerk in screen_ready zet, draait de aanmaaklogica opnieuw op DOM die nog bestaat en komt er een tweede widget bovenop de eerste.
Een ander programma insluiten: xu-panel
xu-panel (tagName in kleine letters, attribuut program) mount een ander Component-programma met eigen velden, datasource en events, in tegenstelling tot een designsysteemtag met hoofdletter. Geef waarden door aan de _in-params met xu-exp:<param>-attributen. Anders dan een designsysteemtag kan een panel via zijn _out-params waarden terugschrijven naar jouw velden.
Uitgewerkt voorbeeld
Kies de vorm
Kies single in het dialoogvenster Nieuwe Component voor één record: bouw direct in de xu-template-root. Kies multi voor een lijst: dat zet een xu-multi-view in die root voor je neer, voeg xu-for (of de for=-afkorting van .xu) toe aan het herhalende node.
Koppel de data
xu-bind voor invoer, xu-exp:xu-content voor berekende tekst, een progDataSource als de component zelf zijn leesactie heeft.
Verbind de interactie
xu-on:click met een workflow, of in .xu een benoemd actieblok waarnaar je met @click verwijst.
Bouw de boom op het canvas: sleep elementen, stel attributen in via het eigenschappenpaneel en koppel xu-on:*-handlers aan workflowstappen in de workflow-editor. Druk op de play-knop van de voorvertoning om het resultaat live te bekijken.
.xu compileert <single-view> naar xu-single-view, :content naar een xu-exp:xu-content-expressie en een kaal for="@list_v"-attribuut naar xu-for.