Hopp til innholdet
Bekreftet

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 er et gammelt flagg, ikke en aktiv egenskap

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.

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

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.

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

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": [] }
  ]
}