Μετάβαση στο περιεχόμενο
Επαληθεύτηκε

Component

Η μονάδα του UI, ένα δέντρο στοιχείων συνδεδεμένο με τοπική κατάσταση, δεδομένα και τη λογική ροής εργασίας που τα συνδέει.

Ένα Component είναι μια μονάδα UI: ένα δέντρο στοιχείων συνδεδεμένο με τοπική κατάσταση, προαιρετικά δεδομένα, λογική κύκλου ζωής και μια διεπαφή εισόδου και εξόδου. Μια σελίδα, μια κάρτα, ένα modal, ένα popover, ένα ενσωματωμένο τμήμα, όλα είναι Components, και είναι ο πιο πλούσιος τύπος εγγράφου της πλατφόρμας: φέρει το δικό του δέντρο UI μαζί με τα πεδία, τα συμβάντα και το datasource που μοιράζεται με κάθε άλλο τύπο προγράμματος.

Ιδιότητες

Το renderType είναι παλιά σημαία, όχι ενεργή ιδιότητα

Το renderType (form / grid / list) έχει καταργηθεί και δεν απαιτείται πια: τα νέα components δημιουργούνται χωρίς αυτό. Αυτό που παίρνει πραγματικά ένα νέο Component είναι μια επιλογή σκελετού, single ή multi, που γίνεται μία φορά στο παράθυρο New Component: το single δημιουργεί μια γυμνή ρίζα xu-template έτοιμη για άμεση δόμηση, ενώ το multi δημιουργεί την ίδια ρίζα xu-template με ένα div φόρτωσης και ένα xu-multi-view ήδη εμφωλευμένα μέσα της. Το xu-single-view εξακολουθεί να είναι υπαρκτή ετικέτα που μπορείτε να χρησιμοποιήσετε, απλώς δεν την τοποθετεί αυτόματα το εργοστάσιο: μόνο ένα παλιό έγγραφο που δεν έχει μεταφερθεί (η ρίζα δεν είναι ακόμη xu-template) ελέγχεται με βάση αυτή, όταν το παλιό renderType εξακολουθεί να λέει form.

progUi, το δέντρο στοιχείων

Ο κόμβος ρίζας είναι πάντα ένα διαφανές xu-template, που δημιουργείται από το scaffold_prog_ui της create_prog. Αν επιλέξετε τον σκελετό multi, μέσα του εμφωλεύονται για εσάς ένα div φόρτωσης και ένα xu-multi-view. Ο σκελετός single το αφήνει άδειο, οπότε χτίζετε απευθείας μέσα στο children του. Κάθε κόμβος χρειάζεται μοναδικό id, type: "element", ένα tagName, καθώς και attributes: {} και children: [] ακόμη και όταν είναι κενά.

Εκτός από τις απλές ετικέτες HTML, μια χούφτα ετικετών xuda γράφονται απευθείας: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.

Ένα tagName με κεφαλαίο αρχικό (Button, Dialog) θεωρείται πάντα μεταγλωττισμένο component design system, ποτέ στοιχείο HTML, ακόμη και όταν είναι τυπογραφικό λάθος: προκαλεί σφάλμα κατά την τοποθέτηση, με το όνομα της ετικέτας και κάθε πηγή που δοκιμάστηκε. Τα απλά χαρακτηριστικά του γίνονται props, όχι χαρακτηριστικά DOM (τα variant, color, class φτάνουν όλα ως props.<name>), και σε αντίθεση με το xu-panel δεν έχει out-params: μια ετικέτα component διαβάζει μόνο ό,τι της περνάτε.

Δυναμική συμπεριφορά: χαρακτηριστικά xu-*

Κάθε χαρακτηριστικό xu-* που μπορεί να φέρει το δέντρο στοιχείων ενός Component:

Δύο είναι εύκολο να μπερδευτούν: το xu-bind παίρνει το σκέτο id πεδίου, χωρίς @, η μία εξαίρεση στον κανόνα του @ παντού αλλού, και το xu-exp:class αντικαθιστά εντελώς το στατικό χαρακτηριστικό class, οπότε οι κλάσεις διάταξης πρέπει να επαναληφθούν μέσα στην έκφραση.

progFields, progEvents, progDataSource

Τοπική κατάσταση (progFields, virtual ή συνδεδεμένα με table), ένα προαιρετικό ενσωματωμένο Datasource και συμβάντα κύκλου ζωής. Τρία από αυτά τα συμβάντα μοιράζουν τη δουλειά με τρόπο που εύκολα μπερδεύεται:

Αν βάλετε εργασία ανανέωσης στο screen_ready, η λογική δημιουργίας εκτελείται ξανά πάνω σε DOM που υπάρχει ακόμη και στοιβάζεται ένα δεύτερο widget πάνω στο πρώτο.

Ενσωμάτωση άλλου προγράμματος: xu-panel

Το xu-panel (tagName με πεζά, χαρακτηριστικό program) τοποθετεί ένα άλλο πρόγραμμα Component με τα δικά του πεδία, datasource και συμβάντα, σε αντίθεση με μια ετικέτα design system με κεφαλαίο αρχικό. Περάστε τιμές στις παραμέτρους του _in με χαρακτηριστικά xu-exp:<param>. Σε αντίθεση με μια ετικέτα design system, ένα panel μπορεί να γράψει τιμές πίσω στα πεδία σας μέσω των παραμέτρων του _out.

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

Ολοκληρωμένο παράδειγμα

Επιλέξτε το σχήμα

Επιλέξτε single στο παράθυρο New Component για μία εγγραφή: χτίστε απευθείας μέσα στη ρίζα xu-template. Επιλέξτε multi για λίστα: δημιουργεί για εσάς ένα xu-multi-view μέσα σε αυτή τη ρίζα, και προσθέτετε xu-for (ή τη συντομογραφία for= του .xu) στον κόμβο που επαναλαμβάνεται.

Συνδέστε τα δεδομένα

xu-bind για εισόδους, xu-exp:xu-content για υπολογιζόμενο κείμενο, ένα progDataSource αν το component έχει τη δική του ανάγνωση.

Συνδέστε την αλληλεπίδραση

xu-on:click με μια ροή εργασίας ή, στο .xu, ένα επώνυμο μπλοκ ενεργειών που αναφέρεται με @click.

Χτίστε το δέντρο στον καμβά: σύρετε στοιχεία, ορίστε χαρακτηριστικά στον πίνακα ιδιοτήτων, συνδέστε χειριστές xu-on:* με βήματα ροής εργασίας στον επεξεργαστή ροής εργασίας. Πατήστε το κουμπί play της προεπισκόπησης για να ελέγξετε το αποτέλεσμα ζωντανά.

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 μεταγλωττίζει το <single-view> σε xu-single-view, το :content σε έκφραση xu-exp:xu-content και ένα σκέτο χαρακτηριστικό for="@list_v" σε 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": [] }
  ]
}