Component
Enheten för gränssnitt, ett elementträd som är bundet till lokalt tillstånd, data och den workflow-logik som knyter ihop det.
En Component är en gränssnittsenhet: ett elementträd bundet till lokalt tillstånd, valfri data, livscykellogik och ett in- och utgränssnitt. En sida, ett kort, en modal, en popover, ett inbäddat fragment, alla är Components, och det är den rikaste dokumenttypen i plattformen. Den bär sitt eget gränssnittsträd vid sidan av fälten, händelserna och datasource som alla andra programtyper delar.
Egenskaper
renderType (form / grid / list) är föråldrad och krävs inte längre. Nya komponenter skapas utan den. Det en ny Component faktiskt får är ett scaffold-val, single eller multi, som väljs en gång i dialogen Ny Component: single lägger in en tom xu-template-rot som är redo att byggas in i direkt, multi lägger in samma xu-template-rot med en laddande div och en xu-multi-view redan nästlad inuti. xu-single-view är fortfarande en riktig tagg som du kan använda, men inte en som fabriken placerar åt dig: bara ett omigrerat äldre dokument (roten är ännu inte xu-template) kontrolleras mot den, när dess föråldrade renderType fortfarande säger form.
progUi, elementträdet
Rotnoden är alltid en genomskinlig xu-template, som läggs in av scaffold_prog_ui i create_prog. Väljer du scaffold multi nästlas en laddande div och en xu-multi-view in i den åt dig. Scaffold single lämnar den tom, bygg direkt i dess children. Varje nod behöver ett unikt id, type: "element", ett tagName, samt attributes: {} och children: [] även när de är tomma.
Förutom vanliga HTML-taggar skrivs en handfull xuda-taggar direkt: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.
Ett tagName med stor bokstav (Button, Dialog) tas alltid som en kompilerad designsystem-komponent, aldrig ett HTML-element, även när det är ett stavfel: då kastas ett fel vid montering som anger taggen och varje källa som provades. Dess vanliga attribut blir props, inte DOM-attribut (variant, color och class kommer alla fram som props.<name>), och till skillnad från xu-panel har den inga utparametrar: en komponenttagg läser bara det du skickar till den.
Dynamiskt beteende: xu-*-attribut
Alla xu-*-attribut som en Components elementträd kan ha:
Två är lätta att vända fel på: xu-bind tar det bara fält-id:t, utan @, det enda undantaget från @-regeln på alla andra ställen. Och xu-exp:class ersätter det statiska attributet class helt, så layoutklasserna måste upprepas i uttrycket.
progFields, progEvents, progDataSource
Lokalt tillstånd (progFields, virtual eller table-bundna), en valfri inbäddad Datasource och livscykelhändelser. Tre av de händelserna delar upp arbetet på ett sätt som är lätt att blanda ihop:
Lägger du uppdateringsarbete i screen_ready körs skapandelogiken om mot DOM som fortfarande finns kvar, och en andra widget hamnar ovanpå den första.
Bädda in ett annat program: xu-panel
xu-panel (tagName med små bokstäver, attributet program) monterar ett annat Component-prog med egna fält, datasource och händelser, till skillnad från en designsystem-tagg med stor bokstav. Skicka värden till dess _in-parametrar med xu-exp:<param>-attribut. Till skillnad från en designsystem-tagg kan en panel skriva värden tillbaka till dina fält via sina _out-parametrar.
Exempel steg för steg
Välj formen
Välj single i dialogen Ny Component för en post: bygg direkt i roten xu-template. Välj multi för en lista: den lägger in en xu-multi-view i roten åt dig, lägg till xu-for (eller .xu-kortformen for=) på noden som upprepas.
Bind datan
xu-bind för inmatningar, xu-exp:xu-content för beräknad text, en progDataSource om komponenten har sin egen läsning.
Koppla ihop interaktionen
xu-on:click med ett workflow, eller i .xu ett namngivet åtgärdsblock som refereras med @click.
Bygg trädet på arbetsytan: dra element, ställ in attribut i egenskapspanelen och koppla xu-on:*-hanterare till workflow-steg i workflow-editorn. Tryck på play-knappen för förhandsgranskning för att se resultatet live.
.xu kompilerar <single-view> till xu-single-view, :content till ett xu-exp:xu-content-uttryck och ett bart attribut for="@list_v" till xu-for.