Hopp til innholdet
Bekreftet

Xu-språket

Blokkformatet hver .xu-kildefil er skrevet i, og de elleve byggeklossene et prosjekt er laget av.

En .xu-fil er en blokkfil, ikke en JavaScript-modul. Hver blokk er ett ansvarsområde, og objektblokkene (<meta>, <params>, <fields>, <actions>, <events>, <datasource>) tolkes som JSON5-lignende literaler: nøkler uten anførselstegn, matriser og nøstede objekter er alle greit.

Elleve byggeklosser

Mappen en kildefil ligger i avgjør hvilken type enhet den kompileres til. En god Xu-app er ofte tydeligere når hvert ansvarsområde får sin egen enhet i stedet for at én fil gjør alt.

App.xu er den ene reserverte filen: den er alltid rotappen og kompileres alltid til program-ID-en app. For en component-fil løses ID-en i rekkefølge fra meta.id, så mount.id, så filens eget basisnavn. Alle andre enhetstyper har ingen <mount>-blokk, så ID-en deres løses fra meta.id, så filens eget basisnavn. For JSON5-ressursene er rekkefølgen id, så _id, så basisnavn. Like ID-er i samme prosjekt er ikke tillatt.

Blokker per enhetstype

App.xu trenger aldri en <mount>-blokk. En vanlig komponent trenger bare en når du vil at den skal monteres direkte i en HTML-side i stedet for å nås gjennom <panel program="...">:

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

Malspråket

Inne i <template> kompileres et lite sett med vennlige aliaser ned til kjøretidens egen xu-*-markup.

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>

En komponent fra start til slutt

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> kompileres til en monteringsmodul på klientsiden: standard-eksporten får et kontekstobjekt og kan returnere en funksjon som rydder opp når siden lukkes. <style>-blokker samles i ett stilark som serveres for komponenten.

Datakildeformat

Bruk den lesbare innpakningsformen inne i <datasource lang="json5">. type er én av none, table, array, json eller 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>

En tabelldatakilde bruker table, filter, sort, direction, realtime, limit, skip og output. En matrise-, JSON- eller CSV-datakilde bruker source.field eller source.url. For datakildenøkler innpakningsformen ikke viser, bytt til mode="raw" og skriv feltnavnene som kjøretidsdokumentet selv bruker.

De ti andre blokkene, kort fortalt

Navngitte, gjenbrukbare lesinger. data/get/LoadStudentClasses.xu kombinerer <params> (deklarerte in/out-felt) med en <datasource>, så en komponent kaller en laster ved navn i stedet for å eie spørringsdetaljene selv.

Navngitte skrivinger. data/set/SaveStudentProfile.xu legger crudMode og allowCreate til i <meta> ved siden av parameterne og datakilden, og gir lagring et synlig, testbart hjem i kilden.

Behandling post for post. data/batch/RebuildClassRoster.xu kjører et <events>-trinn som before_record mot hver rad <datasource> gir.

En <response>-blokk gjør parametere, datakilderesultater og hendelser om til en nyttelast i JSON-stil:

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

En navngitt, gjenbrukbar transformasjon. <code> kjører som en funksjonskropp over de deklarerte in-parameterne og returnerer out-verdien:

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

En gjenbrukbar meldingsdefinisjon som refereres fra en arbeidsflyt i stedet for å skrives inline hver gang:

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

Ruter beskriver hvordan komponenter presenteres som en app man kan navigere i; de erstatter ikke selve komponentene.

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

Et fullstendig eksempel

xuda-studant-app-example er et komplett kildetre som dekker alle elleve blokkene: en påloggingsflyt, et rutet dashbord, studentliste, oppgaver og profilskjermer, tabellbaserte lesinger og skrivinger, og Tailwind-stil. Pakk det ut med:

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
Det finnes også en andre dialekt, på byggetidspunktet

Alt ovenfor er den tolkede dialekten xuda-cli kompilerer: blokker som tolkes ved lagring til progUi / progFields / progEvents-kjøretidsdokumenter, lest av plattformens uttrykksdrevne renderer. En separat, upublisert kompilator (@xuda/compiler, brukt av vite-plugin-xu) leser en smalere .xu-fil som bare består av <template>, <script> og <style>, ignorerer blokknavnene ovenfor, og sender ut en ekte ES-modul på forhånd i stedet for et JSON-dokument. Den retter seg mot den nyere signalbaserte rendereren i @xuda/core, den samme motoren som plattformen leverer som runtime/js/xuda_core.globals.js. Se vite-plugin-xu og @xuda/core for den veien.