Component
Enheten for brukergrensesnitt, et elementtre bundet til lokal tilstand, data og arbeidsflytlogikken som knytter det sammen.
En komponent er en UI-enhet: et elementtre bundet til lokal tilstand, valgfrie data, livssykluslogikk og et grensesnitt for inn- og utdata. En side, et kort, en modal, en popover og et innebygd fragment er alle komponenter. Det er den rikeste dokumenttypen på plattformen, med sitt eget UI-tre ved siden av feltene, hendelsene og datakilden som alle andre programtyper deler.
Egenskaper
renderType (form / grid / list) er foreldet og ikke lenger påkrevd. Nye komponenter opprettes uten den. Det en ny komponent faktisk får, er et stillasvalg, single eller multi, som velges én gang i dialogen for ny komponent: single legger inn en tom xu-template-rot som du kan bygge rett inn i, mens multi legger inn samme xu-template-rot med en div for lasting og en xu-multi-view allerede nøstet inni. xu-single-view er fortsatt en ekte tagg du kan skrive selv, men ikke en fabrikken plasserer for deg: bare et gammelt dokument som ikke er migrert (roten er ennå ikke xu-template) sjekkes mot den, når dets utdaterte renderType fortsatt sier form.
progUi, elementtreet
Rotnoden er alltid en gjennomsiktig xu-template, lagt inn av scaffold_prog_ui i create_prog. Hvis du velger multi-stillaset, nøstes en div for lasting og en xu-multi-view inni den for deg. single-stillaset lar den stå tom, så bygg rett inni children. Hver node trenger en unik id, type: "element", en tagName, og attributes: {} og children: [] selv når de er tomme.
Ved siden av vanlige HTML-tagger skriver du noen få xuda-tagger direkte: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.
Et tagName med stor forbokstav (Button, Dialog) tolkes alltid som en kompilert designsystemkomponent, aldri som et HTML-element, selv når det er en skrivefeil: da kastes en feil ved montering, med tagg og alle kilder som er prøvd. De vanlige attributtene blir props, ikke DOM-attributter (variant, color og class kommer alle som props.<name>), og i motsetning til xu-panel har den ingen ut-parametere: en komponenttagg leser bare det du sender den.
Dynamisk oppførsel: xu-*-attributter
Alle xu-*-attributter som elementtreet i en komponent kan ha:
To er lette å snu på: xu-bind tar bare feltets id, uten @, det eneste unntaket fra @-regelen alle andre steder. Og xu-exp:class erstatter det statiske class-attributtet helt, så layoutklasser må gjentas inne i uttrykket.
progFields, progEvents, progDataSource
Lokal tilstand (progFields, virtual eller bundet til en table), en valgfri innebygd Datasource og livssyklushendelser. Tre av hendelsene deler arbeidet på en måte som er lett å snu på:
Hvis du legger oppdateringsarbeid i screen_ready, kjører opprettingslogikken på nytt mot DOM som fortsatt finnes, og en ny widget havner oppå den første.
Bygge inn et annet program: xu-panel
xu-panel (tagName med små bokstaver, program-attributt) monterer et annet komponentprogram med egne felt, egen datakilde og egne hendelser, i motsetning til en designsystemtagg med stor forbokstav. Send verdier inn i _in-parameterne med xu-exp:<param>-attributter. I motsetning til en designsystemtagg kan et panel skrive verdier tilbake til feltene dine gjennom _out-parameterne.
Eksempel
Velg formen
Velg single i dialogen for ny komponent når du viser én post: bygg rett inni xu-template-roten. Velg multi for en liste: den legger inn en xu-multi-view i roten for deg, og du legger xu-for (eller .xu-snarveien for=) på noden som gjentas.
Bind dataene
xu-bind for inndatafelt, xu-exp:xu-content for beregnet tekst, og en progDataSource hvis komponenten har sin egen lesing.
Koble til interaksjonen
xu-on:click med en arbeidsflyt, eller i .xu en navngitt handlingsblokk som refereres med @click.
Bygg treet på lerretet: dra elementer, sett attributter i egenskapspanelet, og koble xu-on:*-håndterere til arbeidsflyttrinn i arbeidsflyteditoren. Trykk på play-knappen for forhåndsvisning for å sjekke resultatet live.
.xu kompilerer <single-view> til xu-single-view, :content til et xu-exp:xu-content-uttrykk og et enkelt for="@list_v"-attributt til xu-for.