Component
Enheden for brugerflade, et elementtræ bundet til lokal tilstand, data og den workflow-logik, der binder det sammen.
En Component er en brugerfladeenhed: et elementtræ bundet til lokal tilstand, valgfri data, livscykluslogik og en indgangs- og udgangsgrænseflade. En side, et kort, en modal, en popover, et indlejret fragment, de er alle Components, og det er den rigeste dokumenttype på platformen, for den bærer sit eget brugerfladetræ ved siden af de felter, hændelser og den datakilde, som alle andre programtyper deler.
Egenskaber
renderType (form / grid / list) er forældet og kræves ikke længere. Nye komponenter oprettes uden den. Det, en ny Component faktisk får, er et valg af skabelon, single eller multi, som vælges én gang i dialogen Ny Component: single opretter en bar xu-template-rod, klar til at bygge direkte i, mens multi opretter den samme xu-template-rod med en indlæsnings-div og en xu-multi-view, der allerede ligger inde i den. xu-single-view er stadig et reelt tag, du kan bruge, men ikke et, som fabrikken placerer for dig: kun et ikke-migreret gammelt dokument (roden er endnu ikke xu-template) kontrolleres op imod det, når dets forældede renderType stadig siger form.
progUi, elementtræet
Rodnoden er altid en gennemsigtig xu-template, oprettet af create_progs scaffold_prog_ui. Hvis du vælger multi-skabelonen, lægges en indlæsnings-div og en xu-multi-view ind i den for dig. single-skabelonen lader den stå tom, så byg direkte inde i dens children. Hver node skal have et unikt id, type: "element", et tagName samt attributes: {} og children: [], også når de er tomme.
Ud over almindelige HTML-tags kan en række xuda-tags bruges direkte: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.
Et tagName med stort begyndelsesbogstav (Button, Dialog) bliver altid tolket som en kompileret designsystem-komponent, aldrig som et HTML-element, selv når det er en tastefejl: det giver en fejl ved montering, der nævner tagget og alle de kilder, der er prøvet. Dets almindelige attributter bliver til props, ikke DOM-attributter (variant, color og class kommer alle frem som props.<name>), og i modsætning til xu-panel har det ingen out-parametre: et komponenttag læser kun det, du sender til det.
Dynamisk adfærd: xu-*-attributter
Alle xu-*-attributter, som en Components elementtræ kan have:
To af dem er nemme at bytte om på: xu-bind tager det rene felt-id, uden @, den eneste undtagelse fra @-reglen alle andre steder, og xu-exp:class erstatter den statiske class-attribut helt, så layoutklasser skal gentages inde i udtrykket.
progFields, progEvents, progDataSource
Lokal tilstand (progFields, virtual eller bundet til en table), en valgfri indlejret Datasource og livscyklushændelser. Tre af de hændelser deler arbejdet på en måde, der er nem at bytte om på:
Hvis du lægger opdateringsarbejde i screen_ready, kører oprettelseslogikken igen mod DOM, der stadig findes, og der stables en ekstra widget oven på den første.
Indlejring af et andet program: xu-panel
xu-panel (tagName med små bogstaver, program-attribut) monterer et andet Component-program med egne felter, datakilde og hændelser, i modsætning til et designsystem-tag med stort begyndelsesbogstav. Send værdier ind i dets _in-parametre med xu-exp:<param>-attributter. I modsætning til et designsystem-tag kan et panel skrive værdier tilbage til dine felter gennem sine _out-parametre.
Eksempel fra praksis
Vælg formen
Vælg single i dialogen Ny Component til én post: byg direkte inde i xu-template-roden. Vælg multi til en liste: den opretter en xu-multi-view inde i roden for dig, og du tilføjer xu-for (eller .xu-genvejen for=) på den node, der gentages.
Bind dataene
xu-bind til inputfelter, xu-exp:xu-content til beregnet tekst og en progDataSource, hvis komponenten selv ejer sin læsning.
Forbind interaktionen
xu-on:click med et workflow, eller i .xu en navngivet handlingsblok, der henvises til med @click.
Byg træet på lærredet: træk elementer, sæt attributter i panelet med egenskaber, og forbind xu-on:*-handlere til workflow-trin i workflow-editoren. Tryk på forhåndsvisningens afspil-knap for at se resultatet live.
.xu kompilerer <single-view> til xu-single-view, :content til et xu-exp:xu-content-udtryk og en bar for="@list_v"-attribut til xu-for.