Hoppa till innehållet
Verifierad

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 är en äldre flagga, inte en aktiv egenskap

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.

json
{ "id": "ui-…", "type": "element", "tagName": "xu-panel", "attributes": { "program": "392_cmp_child…", "xu-exp:order_id_in": "@selected_order_v" } }

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.

xml
<meta lang="json5">
{
  id: "user_profile_card",
  menuTitle: "User Profile Card",
  uiFramework: "@xuda.io/xuda-framework-plugin-tailwind"
}
</meta>

<params lang="json5">
{
  in: { user_name_in: "string", user_role_in: "string" }
}
</params>

<template>
  <single-view>
    <aside class="user-card">
      <div class="avatar" :content="(@user_name_in || 'A').substring(0, 1)"></div>
      <h3 :content="@user_name_in"></h3>
      <p :content="@user_role_in"></p>
    </aside>
  </single-view>
</template>

<style>
.user-card { display: grid; gap: 0.75rem; padding: 1rem; border-radius: 1.2rem; }
</style>

.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.

json
{
  "properties": { "menuType": "component", "menuName": "Student Card", "rwMode": "U", "allowCreate": false },
  "progUi": [
    { "id": "root", "type": "element", "tagName": "xu-template", "attributes": {}, "children": [] }
  ],
  "progFields": [
    { "id": "b2c3d4e5-…", "data": { "field_id": "STU_Student_Id", "type": "table" }, "props": { "fieldType": "string" } }
  ],
  "progEvents": [
    { "id": "d4e5f6a7-…", "data": { "type": "on_load", "parameters": [], "condition": "" }, "workflow": [] }
  ]
}