Naar de inhoud springen
Geverifieerd

De .xu-taal

Het blokformaat waarin elk .xu-bronbestand is geschreven, en de elf bouwstenen waaruit een project bestaat.

Een .xu-bestand is een blokbestand, geen JavaScript-module. Elk blok is één onderwerp, en de objectblokken (<meta>, <params>, <fields>, <actions>, <events>, <datasource>) worden geparsed als literals in JSON5-stijl: ongequote sleutels, arrays en geneste objecten zijn allemaal prima.

Elf bouwstenen

De map waarin een bronbestand staat, bepaalt naar welk soort eenheid het compileert. Een goede Xu-app leest meestal duidelijker als elk onderwerp een eigen eenheid krijgt in plaats van één bestand dat alles doet.

App.xu is het enige gereserveerde bestand: het is altijd de root-app en compileert altijd naar de programma-id app. Voor een component-bestand wordt de id opgelost in deze volgorde: eerst meta.id, dan mount.id, dan de eigen bestandsnaam zonder extensie. Elk ander eenheidstype heeft geen <mount>-blok, dus de id komt van meta.id en daarna van de eigen bestandsnaam zonder extensie. Voor de JSON5-resources is de volgorde id, dan _id, dan de bestandsnaam zonder extensie. Dubbele id's binnen een project zijn niet toegestaan.

Blokken per eenheidstype

App.xu heeft nooit een <mount>-blok nodig. Een gewone component heeft er alleen een nodig als je hem rechtstreeks in een HTML-pagina wilt mounten in plaats van hem te bereiken via <panel program="...">:

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

De templatetaal

Binnen <template> compileert een kleine set handige aliassen naar de eigen xu-*-markup van de 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>

Een component, van begin tot eind

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> compileert naar een client-side mountmodule: de default export krijgt een contextobject en mag een disposer-functie teruggeven die bij het verwijderen wordt uitgevoerd. <style>-blokken worden verzameld in één geserveerde componentstylesheet.

Datasource-formaat

Gebruik de leesbare wrapper-vorm binnen <datasource lang="json5">. type is none, table, array, json of 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>

Een tabeldatasource gebruikt table, filter, sort, direction, realtime, limit, skip en output. Een array-, JSON- of CSV-datasource gebruikt source.field of source.url. Voor een datasource-sleutel die de wrapper-vorm niet aanbiedt, schakel je over naar mode="raw" en schrijf je de veldnamen die het runtimedocument zelf gebruikt.

De andere tien blokken, in het kort

Benoemde, herbruikbare leesacties. data/get/LoadStudentClasses.xu koppelt <params> (gedeclareerde in/out-velden) aan een <datasource>, zodat een component een loader bij naam aanroept in plaats van zelf de querydetails te beheren.

Benoemde schrijfacties. data/set/SaveStudentProfile.xu voegt crudMode en allowCreate toe aan <meta>, naast de params en de datasource, zodat persistentie een zichtbare, testbare plek in de broncode krijgt.

Verwerking record voor record. data/batch/RebuildClassRoster.xu voert een <events>-stap zoals before_record uit voor elke rij die de <datasource> oplevert.

Een <response>-blok maakt van params, datasource-resultaten en events een payload in JSON-stijl:

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

Een benoemde, herbruikbare transformatie. <code> wordt uitgevoerd als functiebody over de gedeclareerde in-params en geeft de out-waarde terug:

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

Een herbruikbare berichtdefinitie, waarnaar een workflow verwijst in plaats van dat je hem elke keer inline schrijft:

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 beschrijven hoe componenten worden gepresenteerd als een navigeerbare app; ze vervangen de componenten zelf niet.

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

Een volledig voorbeeld

xuda-studant-app-example is een complete bronboom die alle elf bouwstenen dekt: een loginflow, een dashboard met routes, studentenlijst, taken- en profielschermen, lees- en schrijfacties op tabellen en Tailwind-styling. Pak hem uit met:

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
Er bestaat ook een tweede dialect voor buildtijd

Alles hierboven is het geïnterpreteerde dialect dat xuda-cli compileert: blokken die bij het opslaan worden geparsed tot runtimedocumenten progUi / progFields / progEvents, gelezen door de expressiegedreven renderer van het platform. Een aparte, niet gepubliceerde compiler (@xuda/compiler, gebruikt door vite-plugin-xu) leest een smaller .xu-bestand dat alleen uit <template>, <script> en <style> bestaat, negeert de bloknamen hierboven en levert vooraf een echte ES-module op in plaats van een JSON-document. Hij richt zich op de nieuwere, op signals gebaseerde renderer in @xuda/core, dezelfde engine die het platform meelevert als runtime/js/xuda_core.globals.js. Zie vite-plugin-xu en @xuda/core voor dat pad.