Přeskočit na obsah
Ověřeno

Jazyk .xu

Blokový formát, ve kterém se píše každý zdrojový soubor .xu, a jedenáct stavebních bloků, z nichž se projekt skládá.

Soubor .xu je blokový soubor, ne modul JavaScriptu. Každý blok řeší jednu věc a objektové bloky (<meta>, <params>, <fields>, <actions>, <events>, <datasource>) se parsují jako literály ve stylu JSON5: klíče bez uvozovek, pole i vnořené objekty jsou v pořádku.

Jedenáct stavebních bloků

Složka, ve které zdrojový soubor leží, určuje, na jaký druh jednotky se zkompiluje. Aplikace Xu bývá přehlednější, když každá věc dostane vlastní jednotku místo toho, aby jeden soubor dělal všechno.

App.xu je jediný vyhrazený soubor: je vždy kořenovou aplikací a vždy se kompiluje na id programu app. U souboru typu component se id určí v pořadí z meta.id, pak z mount.id, pak z vlastního základu názvu souboru. Každý jiný typ jednotky nemá blok <mount>, takže jeho id se určí z meta.id a poté ze základu názvu souboru. U zdrojů JSON5 je pořadí id, pak _id, pak základ názvu. Duplicitní id v rámci projektu nejsou povolena.

Bloky podle typu jednotky

App.xu blok <mount> nikdy nepotřebuje. Běžná komponenta ho potřebuje jen tehdy, když ji chcete připojit přímo do stránky HTML místo dosažení přes <panel program="...">:

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

Jazyk šablon

Uvnitř <template> se malá sada přívětivých aliasů kompiluje do vlastního značení xu-* runtime.

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>

Komponenta od začátku do konce

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 kompiluje do klientského modulu pro připojení: výchozí export dostane objekt kontextu a může vrátit funkci pro uvolnění, která se spustí při odpojení. Bloky <style> se sbírají do jednoho servírovaného stylu komponenty.

Formát zdroje dat

Uvnitř <datasource lang="json5"> používejte čitelnou obalovou formu. type je jedno z none, table, array, json nebo 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>

Zdroj dat typu tabulka používá table, filter, sort, direction, realtime, limit, skip a output. Zdroj dat typu pole, JSON nebo CSV používá source.field nebo source.url. Pro každý klíč zdroje dat, který obalová forma nezpřístupňuje, přepněte na mode="raw" a pište názvy polí, které používá samotný runtime dokument.

Zbývajících deset bloků stručně

Pojmenovaná, opakovaně použitelná čtení. data/get/LoadStudentClasses.xu spojuje <params> (deklarovaná pole in/out) s <datasource>, takže komponenta volá načítač jménem a sama nevlastní podrobnosti dotazu.

Pojmenované zápisy. data/set/SaveStudentProfile.xu přidává do <meta> crudMode a allowCreate vedle parametrů a zdroje dat, čímž dává ukládání viditelné a testovatelné místo ve zdroji.

Zpracování záznam po záznamu. data/batch/RebuildClassRoster.xu spouští krok <events>, například before_record, na každém řádku, který <datasource> vrátí.

Blok <response> mění parametry, výsledky zdroje dat a události v datovou strukturu ve stylu JSON:

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

Pojmenovaná, opakovaně použitelná transformace. <code> běží jako tělo funkce nad deklarovanými parametry in a vrací hodnotu out:

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

Opakovaně použitelná definice zprávy, na kterou se odkazuje z workflow, místo aby se pokaždé psala přímo:

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

Trasy popisují, jak se komponenty prezentují jako navigovatelná aplikace; samotné komponenty nenahrazují.

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

Úplný příklad

xuda-studant-app-example je kompletní zdrojový strom pokrývající všech jedenáct bloků: tok přihlášení, směrovaný přehled, seznam studentů, obrazovky úkolů a profilu, čtení a zápisy nad tabulkami a styly Tailwind. Rozbalte ho takto:

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
Existuje i druhý dialekt, při sestavení

Vše výše je interpretovaný dialekt, který kompiluje xuda-cli: bloky parsované při uložení do runtime dokumentů progUi / progFields / progEvents, které čte renderer platformy řízený výrazy. Samostatný, nepublikovaný kompilátor (@xuda/compiler, používaný vite-plugin-xu) čte užší soubor .xu složený jen z <template>, <script> a <style>, názvy bloků výše ignoruje a místo dokumentu JSON předem vytváří skutečný modul ES. Míří na novější renderer založený na signálech v @xuda/core, tentýž engine, který platforma dodává jako runtime/js/xuda_core.globals.js. Pro tuto cestu viz vite-plugin-xu a @xuda/core.