Sari la conținut
Verificat

Limbajul .xu

Formatul de blocuri în care este scris fiecare fișier sursă .xu și cele unsprezece elemente de bază din care este făcut un proiect.

Un fișier .xu este un fișier de blocuri, nu un modul JavaScript. Fiecare bloc se ocupă de un singur aspect, iar blocurile de tip obiect (<meta>, <params>, <fields>, <actions>, <events>, <datasource>) sunt parsate ca literali în stil JSON5: chei fără ghilimele, array-uri și obiecte imbricate sunt toate în regulă.

Unsprezece elemente de bază

Folderul în care se află un fișier sursă decide în ce fel de unitate se compilează. O aplicație Xu bună se citește de obicei mai clar când fiecare aspect are propria unitate, în loc să facă un singur fișier totul.

App.xu este singurul fișier rezervat: este întotdeauna aplicația rădăcină și se compilează întotdeauna la id-ul de program app. Pentru un fișier component, id-ul se rezolvă în ordine din meta.id, apoi mount.id, apoi numele de bază al fișierului. Orice alt tip de unitate nu are bloc <mount>, deci id-ul ei se rezolvă din meta.id, apoi din numele de bază al fișierului. Pentru resursele JSON5 ordinea este id, apoi _id, apoi numele de bază. Id-urile duplicate într-un proiect nu sunt permise.

Blocuri pe tip de unitate

App.xu nu are niciodată nevoie de un bloc <mount>. O componentă obișnuită are nevoie de unul doar când vrei ca ea să fie montată direct într-o pagină HTML, în loc să fie accesată prin <panel program="...">:

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

Limbajul de template

În interiorul <template>, un mic set de alias-uri prietenoase se compilează în markup-ul xu-* propriu al runtime-ului.

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>

O componentă, de la cap la coadă

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> se compilează într-un modul de montare pe client: exportul implicit primește un obiect de context și poate returna o funcție de eliberare, care rulează la descărcare. Blocurile <style> sunt colectate într-un singur stylesheet servit al componentei.

Formatul datasource

Folosește forma de wrapper lizibilă în interiorul <datasource lang="json5">. type este una dintre none, table, array, json sau 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>

Un datasource de tip tabel folosește table, filter, sort, direction, realtime, limit, skip și output. Un datasource de tip array, JSON sau CSV folosește source.field sau source.url. Pentru orice cheie de datasource pe care forma wrapper nu o expune, treci la mode="raw" și scrie numele de câmp pe care le folosește chiar documentul de runtime.

Celelalte zece blocuri, pe scurt

Citiri cu nume, reutilizabile. data/get/LoadStudentClasses.xu asociază <params> (câmpuri in/out declarate) cu un <datasource>, așa că o componentă apelează un încărcător pe nume, în loc să dețină ea detaliile interogării.

Scrieri cu nume. data/set/SaveStudentProfile.xu adaugă crudMode și allowCreate la <meta>, alături de params și datasource, oferind persistenței un loc vizibil și testabil în sursă.

Procesare înregistrare cu înregistrare. data/batch/RebuildClassRoster.xu rulează un pas <events>, cum ar fi before_record, pe fiecare rând pe care îl rezolvă <datasource>.

Un bloc <response> transformă params, rezultatele datasource și evenimentele într-un payload în stil JSON:

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

O transformare cu nume, reutilizabilă. <code> rulează ca un corp de funcție peste parametrii in declarați și returnează valoarea out:

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

O definiție de mesaj reutilizabilă, referențiată dintr-un flux de lucru în loc să fie scrisă inline de fiecare dată:

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

Rutele descriu cum sunt prezentate componentele ca aplicație navigabilă; nu înlocuiesc componentele în sine.

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

Un exemplu complet

xuda-studant-app-example este un arbore sursă complet care acoperă toate cele unsprezece blocuri: un flux de conectare, un tablou de bord cu rute, ecrane de listă de studenți, sarcini și profil, citiri și scrieri pe tabele și stilizare Tailwind. Despachetează-l cu:

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
Există și un al doilea dialect, la momentul build-ului

Tot ce este mai sus este dialectul interpretat pe care îl compilează xuda-cli: blocuri parsate la salvare în documente de runtime progUi / progFields / progEvents, citite de renderer-ul platformei, condus de expresii. Un compilator separat, nepublicat (@xuda/compiler, folosit de vite-plugin-xu), citește un fișier .xu mai restrâns, format doar din <template>, <script> și <style>, ignoră numele de blocuri de mai sus și emite din timp un modul ES real, în loc de un document JSON. Vizează renderer-ul mai nou bazat pe semnale din @xuda/core, același motor pe care platforma îl livrează ca runtime/js/xuda_core.globals.js. Vezi vite-plugin-xu și @xuda/core pentru acea cale.