İçeriğe geç
Doğrulandı

.xu dili

Her .xu kaynak dosyasının yazıldığı blok biçimi ve bir projenin oluştuğu on bir yapı taşı.

Bir .xu dosyası bir blok dosyasıdır, JavaScript modülü değildir. Her blok tek bir sorumluluktur ve nesne blokları (<meta>, <params>, <fields>, <actions>, <events>, <datasource>) JSON5 tarzı değişmezler olarak ayrıştırılır: tırnaksız anahtarlar, diziler ve iç içe nesneler serbesttir.

On bir yapı taşı

Bir kaynak dosyasının bulunduğu klasör, hangi tür birime derleneceğini belirler. İyi bir Xu uygulaması, her şeyi tek dosyaya yüklemek yerine her sorumluluğa ayrı bir birim verildiğinde genellikle daha anlaşılır okunur.

App.xu ayrılmış tek dosyadır: her zaman kök uygulamadır ve her zaman app program kimliğine derlenir. Bir component dosyası için kimlik sırasıyla meta.id, sonra mount.id, sonra dosyanın kendi temel adından çözülür. Diğer her birim türü bir <mount> bloğu taşımaz; bu yüzden kimliği meta.id, sonra dosyanın kendi temel adından çözülür. JSON5 kaynakları için sıra id, sonra _id, sonra temel addır. Bir proje genelinde yinelenen kimliklere izin verilmez.

Birim türüne göre bloklar

App.xu hiçbir zaman bir <mount> bloğuna ihtiyaç duymaz. Sıradan bir bileşenin buna yalnızca, <panel program="..."> üzerinden ulaşılmak yerine doğrudan bir HTML sayfasına bağlanmasını istediğinizde ihtiyacı olur:

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

Şablon dili

<template> içinde, küçük bir dost takma ad kümesi çalışma zamanının kendi xu-* işaretlemesine derlenir.

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>

Baştan sona bir bileşen

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>, istemci tarafı bir bağlama modülüne derlenir: varsayılan dışa aktarım bir bağlam nesnesi alır ve kaldırma sırasında çalıştırılacak bir yok edici fonksiyon döndürebilir. <style> blokları tek bir sunulan bileşen stil sayfasında toplanır.

Veri kaynağı biçimi

<datasource lang="json5"> içinde okunabilir sarmalayıcı biçimini kullanın. type, none, table, array, json veya csv değerlerinden biridir.

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>

Bir tablo veri kaynağı table, filter, sort, direction, realtime, limit, skip ve output kullanır. Bir dizi, JSON veya CSV veri kaynağı source.field ya da source.url kullanır. Sarmalayıcı biçiminin sunmadığı bir veri kaynağı anahtarı için mode="raw" kullanın ve çalışma zamanı belgesinin kendi kullandığı alan adlarını yazın.

Diğer on blok, kısaca

Adlandırılmış, yeniden kullanılabilir okumalar. data/get/LoadStudentClasses.xu, <params> (bildirilmiş in/out alanları) ile bir <datasource> birleştirir; böylece bir bileşen sorgu ayrıntılarını kendisi taşımak yerine bir yükleyiciyi adıyla çağırır.

Adlandırılmış yazmalar. data/set/SaveStudentProfile.xu, params ve veri kaynağının yanında <meta> içine crudMode ve allowCreate ekler; böylece kalıcılığa kaynakta görünür, test edilebilir bir yer verir.

Kayıt kayıt işleme. data/batch/RebuildClassRoster.xu, <datasource> tarafından çözülen her satır için before_record gibi bir <events> adımı çalıştırır.

Bir <response> bloğu, parametreleri, veri kaynağı sonuçlarını ve olayları JSON tarzı bir yüke dönüştürür:

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

Adlandırılmış, yeniden kullanılabilir bir dönüşüm. <code>, bildirilen in parametreleri üzerinde bir fonksiyon gövdesi olarak çalışır ve out değerini döndürür:

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

Yeniden kullanılabilir bir mesaj tanımı; her seferinde satır içi yazılmak yerine bir iş akışından başvurulur:

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

Rotalar, bileşenlerin gezilebilir bir uygulama olarak nasıl sunulacağını tanımlar; bileşenlerin kendisinin yerini almazlar.

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

Tam bir örnek

xuda-studant-app-example, on bir bloğun hepsini kapsayan eksiksiz bir kaynak ağacıdır: bir oturum açma akışı, yönlendirmeli bir gösterge tablosu, öğrenci listesi, görev ve profil ekranları, tablo destekli okuma ve yazmalar ve Tailwind stili. Şununla açın:

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
İkinci, derleme zamanı bir lehçe de var

Yukarıdakilerin hepsi, xuda-cli'nin derlediği yorumlanan lehçedir: bloklar kayıt sırasında progUi / progFields / progEvents çalışma zamanı belgelerine ayrıştırılır ve platformun ifade tabanlı oluşturucusu tarafından okunur. Ayrı, yayımlanmamış bir derleyici (vite-plugin-xu'nun kullandığı @xuda/compiler), yalnızca <template>, <script> ve <style> içeren daha dar bir .xu dosyasını okur, yukarıdaki blok adlarını yok sayar ve bir JSON belgesi yerine önceden gerçek bir ES modülü üretir. Platformun runtime/js/xuda_core.globals.js olarak gönderdiği aynı motor olan @xuda/core içindeki daha yeni, sinyal tabanlı oluşturucuyu hedefler. Bu yol için vite-plugin-xu ve @xuda/core sayfalarına bakın.