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

Η γλώσσα .xu

Η μορφή blocks στην οποία γράφεται κάθε αρχείο πηγαίου κώδικα .xu, και τα έντεκα δομικά στοιχεία από τα οποία αποτελείται ένα έργο.

Ένα αρχείο .xu είναι αρχείο blocks, όχι module JavaScript. Κάθε block είναι ένα ζήτημα, και τα blocks αντικειμένων (<meta>, <params>, <fields>, <actions>, <events>, <datasource>) αναλύονται ως literals τύπου JSON5: κλειδιά χωρίς εισαγωγικά, πίνακες και ένθετα αντικείμενα είναι όλα δεκτά.

Έντεκα δομικά στοιχεία

Ο φάκελος όπου βρίσκεται ένα αρχείο πηγαίου κώδικα καθορίζει σε ποιο είδος μονάδας μεταγλωττίζεται. Μια καλή εφαρμογή Xu συνήθως διαβάζεται πιο καθαρά όταν κάθε ζήτημα έχει τη δική του μονάδα αντί για ένα αρχείο που κάνει τα πάντα.

Το App.xu είναι το μοναδικό δεσμευμένο αρχείο: είναι πάντα η βασική εφαρμογή και μεταγλωττίζεται πάντα στο αναγνωριστικό προγράμματος app. Για ένα αρχείο component το αναγνωριστικό επιλύεται με τη σειρά από το meta.id, μετά το mount.id, μετά το όνομα βάσης του ίδιου του αρχείου. Κάθε άλλος τύπος μονάδας δεν έχει block <mount>, οπότε το αναγνωριστικό του επιλύεται από το meta.id και μετά από το όνομα βάσης του αρχείου. Για τους πόρους JSON5 η σειρά είναι id, μετά _id, μετά όνομα βάσης. Διπλά αναγνωριστικά σε ένα έργο δεν επιτρέπονται.

Blocks ανά τύπο μονάδας

Το App.xu δεν χρειάζεται ποτέ block <mount>. Ένα συνηθισμένο στοιχείο χρειάζεται μόνο όταν θέλετε να προσαρτηθεί απευθείας σε μια σελίδα HTML αντί να προσεγγίζεται μέσω <panel program="...">:

xml
<mount>
{
  id: "marketing_hero",
  file: "landing.html",
  selector: "#hero"
}
</mount>

Η γλώσσα των templates

Μέσα στο <template>, ένα μικρό σύνολο φιλικών aliases μεταγλωττίζεται στο δικό του markup xu-* του περιβάλλοντος εκτέλεσης.

xml
<template>
  <single-view>
    <section class="screen">
      <input bind="search_v" placeholder="Search students">
      <button @click="togglePanel">Toggle panel</button>

      <div if="@show_panel_v">
        <panel program="student_details" />
      </div>
    </section>
  </single-view>
</template>

Ένα στοιχείο, από την αρχή μέχρι το τέλος

xml
<meta lang="json5">
{
  id: "student_list",
  menuTitle: "Student List",
  uiFramework: "@xuda.io/xuda-framework-plugin-tailwind"
}
</meta>

<fields lang="json5">
{
  show_panel_v: { type: "boolean", value: false },
  student_count_v: { type: "number", value: 3 }
}
</fields>

<actions lang="json5">
{
  togglePanel: [
    { action: "update", name: { value: "@show_panel_v: !@show_panel_v" } }
  ]
}
</actions>

<template>
  <single-view>
    <section class="p-6 space-y-4">
      <h1>Students</h1>
      <p :content="'Count: ' + @student_count_v"></p>
      <button class="rounded-full px-4 py-2 bg-sky-600 text-white" @click="togglePanel">
        Toggle details
      </button>
      <div if="@show_panel_v">
        <panel program="student_details" />
      </div>
    </section>
  </single-view>
</template>

Το <script> μεταγλωττίζεται σε module προσάρτησης από την πλευρά του client: η προεπιλεγμένη εξαγωγή δέχεται ένα αντικείμενο context και μπορεί να επιστρέψει μια συνάρτηση αποδέσμευσης που θα εκτελεστεί κατά την αποφόρτωση. Τα blocks <style> συγκεντρώνονται σε ένα ενιαίο φύλλο στυλ στοιχείου που σερβίρεται.

Μορφή πηγής δεδομένων

Χρησιμοποιήστε την αναγνώσιμη μορφή wrapper μέσα στο <datasource lang="json5">. Το type είναι ένα από none, table, array, json ή csv.

xml
<datasource lang="json5">
{
  type: "table",
  table: "student_profiles_table",
  filter: {
    mode: "index",
    activeIndex: "campus_idx",
    indexes: {
      campus_idx: { campus: { from: "@campus_in", to: "@campus_in" } }
    }
  },
  output: "students_out",
  direction: "asc",
  realtime: true,
  limit: 25
}
</datasource>
xml
<datasource lang="json5">
{
  type: "table",
  table: "student_tasks_table",
  filter: {
    mode: "query",
    query: { $and: [{ status: "Open" }, { campus: "Boston Campus" }] }
  },
  output: "tasks_out"
}
</datasource>
xml
<datasource lang="json5">
{
  type: "json",
  source: { url: "https://example.com/students.json" },
  output: "students_out"
}
</datasource>
xml
<datasource lang="json5" mode="raw">
{
  "dataSourceType": "table",
  "dataSourceTableId": "student_profiles_table"
}
</datasource>

Μια πηγή δεδομένων τύπου πίνακα χρησιμοποιεί table, filter, sort, direction, realtime, limit, skip και output. Μια πηγή τύπου array, JSON ή CSV χρησιμοποιεί source.field ή source.url. Για οποιοδήποτε κλειδί πηγής δεδομένων που η μορφή wrapper δεν εκθέτει, περάστε σε mode="raw" και γράψτε τα ονόματα πεδίων που χρησιμοποιεί το ίδιο το έγγραφο εκτέλεσης.

Τα άλλα δέκα blocks, σύντομα

Ονομασμένες, επαναχρησιμοποιήσιμες αναγνώσεις. Το data/get/LoadStudentClasses.xu συνδυάζει <params> (δηλωμένα πεδία in/out) με ένα <datasource>, ώστε ένα στοιχείο να καλεί έναν φορτωτή με το όνομά του αντί να κατέχει το ίδιο τις λεπτομέρειες του ερωτήματος.

Ονομασμένες εγγραφές. Το data/set/SaveStudentProfile.xu προσθέτει crudMode και allowCreate στο <meta> μαζί με τα params και την πηγή δεδομένων, δίνοντας στην αποθήκευση ένα ορατό, ελέγξιμο σπίτι στον πηγαίο κώδικα.

Επεξεργασία εγγραφή προς εγγραφή. Το data/batch/RebuildClassRoster.xu εκτελεί ένα βήμα <events> όπως το before_record για κάθε γραμμή που επιλύει το <datasource>.

Ένα block <response> μετατρέπει params, αποτελέσματα πηγής δεδομένων και συμβάντα σε ένα payload τύπου JSON:

xml
<response>
({ ok: true, count: (@students_out || []).length, rows: @students_out })
</response>

Ένας ονομασμένος, επαναχρησιμοποιήσιμος μετασχηματισμός. Το <code> εκτελείται ως σώμα συνάρτησης πάνω στα δηλωμένα params in και επιστρέφει την τιμή out:

xml
<code>
return (@raw_name_in || "")
  .trim()
  .toLowerCase()
  .replace(/\b\w/g, (letter) => letter.toUpperCase());
</code>

Ένας επαναχρησιμοποιήσιμος ορισμός μηνύματος, που αναφέρεται από μια ροή εργασίας αντί να γράφεται απευθείας κάθε φορά:

xml
<alert lang="json5">
{
  alertDisplay: "toast",
  alertType: "success",
  alertTitle: "Student saved",
  createLog: false
}
</alert>
json5
{
  id: "student_profiles_table",
  menuTitle: "Student Profiles Table",
  fields: [
    { field_id: "student_id", type: "string" },
    { field_id: "full_name", type: "string" }
  ],
  indexes: [{ id: "campus_idx", name: "Campus", keys: ["campus"] }]
}
json5
{
  id: "app_route",
  menuTitle: "App Route",
  menu: [
    { title: "Overview", prog: "app" },
    { title: "Students", prog: "student_list" }
  ]
}

Οι διαδρομές (routes) περιγράφουν πώς τα στοιχεία παρουσιάζονται ως πλοηγήσιμη εφαρμογή· δεν αντικαθιστούν τα ίδια τα στοιχεία.

json5
{
  id: "class_helper",
  menuTitle: "Class Helper",
  config: { provider: "openai", model: "gpt-5" }
}

Ένα πλήρες παράδειγμα

Το xuda-studant-app-example είναι ένα πλήρες δέντρο πηγαίου κώδικα που καλύπτει και τα έντεκα blocks: μια ροή σύνδεσης, ένα dashboard με διαδρομές, οθόνες καταλόγου μαθητών, εργασιών και προφίλ, αναγνώσεις και εγγραφές με υποστήριξη πίνακα, και στυλ Tailwind. Αποσυμπιέστε το με:

bash
mkdir xuda-studant-app-example
cd xuda-studant-app-example
npm pack xuda-studant-app-example
tar -xzf xuda-studant-app-example-*.tgz --strip-components=1 package
rm xuda-studant-app-example-*.tgz
npm install
npm run dev
Υπάρχει και μια δεύτερη διάλεκτος χρόνου build

Όλα τα παραπάνω αφορούν τη διερμηνευόμενη διάλεκτο που μεταγλωττίζει το xuda-cli: blocks που αναλύονται κατά την αποθήκευση σε έγγραφα εκτέλεσης progUi / progFields / progEvents, τα οποία διαβάζει ο renderer της πλατφόρμας που καθοδηγείται από εκφράσεις. Ένας ξεχωριστός, μη δημοσιευμένος compiler (@xuda/compiler, που χρησιμοποιείται από το vite-plugin-xu) διαβάζει ένα στενότερο αρχείο .xu που αποτελείται μόνο από <template>, <script> και <style>, αγνοεί τα ονόματα blocks που αναφέρονται παραπάνω, και εκπέμπει εκ των προτέρων ένα πραγματικό module ES αντί για έγγραφο JSON. Στοχεύει τον νεότερο renderer βασισμένο σε signals στο @xuda/core, την ίδια μηχανή που η πλατφόρμα διανέμει ως runtime/js/xuda_core.globals.js. Δείτε το vite-plugin-xu και το @xuda/core για αυτόν τον δρόμο.