.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:
Şablon dili
<template> içinde, küçük bir dost takma ad kümesi çalışma zamanının kendi xu-* işaretlemesine
derlenir.
Baştan sona bir bileşen
<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.
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:
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:
Yeniden kullanılabilir bir mesaj tanımı; her seferinde satır içi yazılmak yerine bir iş akışından başvurulur:
Rotalar, bileşenlerin gezilebilir bir uygulama olarak nasıl sunulacağını tanımlar; bileşenlerin kendisinin yerini almazlar.
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:
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.