Studio LLM kılavuzu
Prog belge modeli, xu-* öznitelik başvurusu ve bir yapay zekâ ajanına ilk araç çağrısından önce öğretilen iş akışı kuralları.
Her Studio projesi, içindeki her tablo, ekran, betik ve rota, prog adı verilen tek bir CouchDB JSON
belgesidir (docType: "studio"). Bu sayfa, bir yapay zekâ ajanının bir tane oluştururken aldığı aynı
başvurudur; dokümantasyon olarak yeniden yazılmıştır: o belgenin şekli, arayüzünü yönlendiren
öznitelikler, bir iş akışının yapabileceği eylemler ve gerçek derlemelerde ortaya çıkan hatalar.
Bir yapay zekâ ajanı bu kılavuzu nasıl alır
Bir MCP istemcisini Xuda'ya bağlayın; ilk yanıt, yani initialize çağrısı, bu kılavuzu oturumun
instructions alanı olarak taşır. Platformun kendi canlı kurallarından yeniden birleştirilir; bu
yüzden dağıtılmış denetleyicinin artık uygulamadığı bir şeyi asla anlatamaz. Bkz.
Bir yapay zekâ istemcisini MCP ile bağlama.
Bir oturumun içinden iki yöntem aynı malzemeye doğrudan, MCP ya da düz REST üzerinden ulaşır ve normal bir API anahtarının ötesinde hiçbir şey gerektirmez:
Öngörülen sıra: oluşturduğunuz şeyle eşleşen konuyu okuyun, eşleşen bir örnek getirin, progu fabrika
aracılığıyla oluşturun (create_prog), içerik bölümlerinin içinde derleyin, doğrulayın
(validate_prog) ve bildirdiği her şeyi düzeltin, kaydedin (save_prog), sonra doğrulamak için yeniden
getirin. -409 döndüren bir kayıt, belgenin okunduğundan beri değiştiği anlamına gelir: yeniden
getirin, yeniden uygulayın, yeniden deneyin.
Prog belge modeli
Zarf
Bu alanlar sunucu ve fabrika koduna aittir; yazılan bir derleme yalnızca altındaki içerik bölümlerini düzenler.
_id,<app_id son 3 karakter>_<3 harfli tür kısaltması>_<12 onaltılık>biçimini izler; örneğin bir bileşen için392_cmp_..., bir tablo için392_tbl_..., bir javascript progu için392_jvs_..., get_data / set_data için392_gtd_.../392_std_..., bir klasör için392_fld_.... Kimlikleri fabrika üretir, bir derleme asla kimlik uydurmaz.stat, etkin için 3, yumuşak silinmiş için 4'tür (bir progu silmenin ayarladığı değer). Studio'nun ağacı yalnızcastat: 3olanları gösterir.properties.menuType,globals,table,get_data,set_data,batch,alert,javascript,folder,route,api,component,ai_agentdeğerlerinden biridir.studio_meta.parentIddüğümü Studio ağacında konumlandırır: ya başka bir progun kimliği (genellikle bir klasör) ya da tür köklerinden biri:programs(mantık ve bileşenler),database(tablolar),routes,globals,ai_agents. Tanınmayan birparentId, düğümü ağaçta görünmez bırakır ve bir denetleyici hatasıdır.
menuType'a göre içerik bölümleri
Globals belgesi
Her projenin tam olarak bir global_<app_id> belgesi vardır (menuType: "globals"). progFields
alanları, diğer her progdan @field_id olarak okunabilir. Her projede iki sistem globali gelir:
oturum açmış kullanıcı için @SYS_GLOBAL_OBJ_LOGIN_USER_INFO ve xu-ref ile kaydedilen öğeler için
@SYS_GLOBAL_OBJ_REFS. Ne globals belgesi ne de ağaç kökü silinebilir.
Yapısal zorunluluklar
properties,properties.menuType,properties.menuName,studio_metavestudio_meta.parentIdher belgede zorunludur.- Bir
progFieldsgirdisi benzersiz birid,data.field_id,virtual,table,expressionveyadatasourcedeğerlerinden biri olan birdata.typevestring,number,boolean,arrayveyaobjectdeğerlerinden biri olan birprops.fieldTypegerektirir. - Ayrılmış çalışma zamanı değişken adları,
_NULL,_THIS,_FOR_KEY,_FOR_VAL,_ROWNO,_ROWID,_ROWDOC,_KEY,_VAL, asla alan kimliği olarak yeniden tanımlanmaz. - Yinelenen kimlikler, bilinmeyen
menuTypedeğerleri ve hatalı biçimli bölümlerin hepsi,validate_prog'un doğrudan bildirdiği kesin hatalardır.
İfadeler ve xu-* öznitelikleri
İfade sözdizimi
İfadeler progun kendi veri kümesine karşı çalışır. Yerel, tabloya bağlı, global ya da bir parametre olan
her alana @ ile başvurulur: @search_v, @ORD_Total, @SYS_GLOBAL_OBJ_LOGIN_USER_INFO, etrafında
düz JavaScript, @count_v > 0 ? 'has rows' : 'empty'. Bir nesne değişmezinin etrafında parantez gerekir,
({ ORD_Status: @status_v }). Bir xu-for döngüsünün içinde geçerli öğe @_FOR_VAL, anahtarı veya
dizini @_FOR_KEY'dir (xu-for-key / xu-for-val ile yeniden adlandırılabilir). xu-render ve diğer
koşullar doğru ya da yanlış değeri doğrudan döndürür; asla bir "Y" / "N" dizesi ya da ek bir
karşılaştırma değil.
Başka her yerde bir alana @ ile başvurulur. xu-bind bunun yerine yalın alan kimliğini alır:
xu-bind="search_v", asla xu-bind="@search_v" değil.
xu öznitelikleri
Önek aileleri
Sonek alan öznitelik aileleri. xu-on değerleri her zaman işleyici nesnelerinden oluşan dizilerdir;
xu-exp değerleri her zaman ifade dizeleridir.
Bir xu-on:* özniteliğinin değeri her zaman işleyici nesnelerinden oluşan bir dizidir ve her
workflow, eylem adımlarından oluşan bir dizidir (tam eylem başvurusu aşağıda, Mantık programları ve
iş akışları altındadır). Bir adımın props.condition değeri onu sınırlar; props.async: true onu
beklemeden tetikler.
Kritik anlambilim
xu-exp:class, statikclassözniteliğine eklemek yerine onu değiştirir. İkisini de taşıyan bir öğede statik olan yok sayılır; bu yüzden yerleşim sınıfları da ifadenin içine aittir:xu-exp:class="'card p-4 ' + (@active_v ? 'ring' : '')".xu-script, yalın birfunction (el) { ... }ifadesi alır; düğüm görünür olduğundaevaledilir ve DOM öğesiyle çağrılır. Yeniden çalışmalara karşı koruma ekleyin (if (el.__bound) return; el.__bound = true;) ve her sorguyudocumentile değilelile sınırlayın.xu-styleotomatik olarak kapsamlıdır: her seçici düğümün[xu-ui-id]değeriyle öneklenir; bu yüzden düz öğe ve sınıf seçicileri yerel kalır ve asla sızmaz.- Ne
xu-scriptne dexu-styledeğerleri bir tırnak karakteri ('veya") içerebilir; tasarımcı tuvali öznitelikleri kaçışsız serileştirir ve tek bir tırnak bileşeni bozar. Aşağıdaki JavaScript programları bölümü tırnaksız teknikleri kapsar. - Statik metin bir öğenin
contentözelliğine aittir.xu-exp:xu-contentyalnızca dinamik metin içindir.
Etiketler
Düz HTML dışındaki yazım etiketleri: xu-template, xu-single-view, xu-multi-view, xu-panel,
xu-teleport, xu-slot.
xu-single-viewtek bir kaydı kapsar (bir form kökü, iç içe de kullanılabilir).xu-multi-viewalt öğelerini bağlı verinin her satırı için bir kez tekrarlar.xu-panelbaşka bir progu gömer (programözniteliği artıxu-exp:<param>girdileri). Param ifadelerinin yanında yalnızca standart HTML öznitelikleri (class,id,style,title,hidden,slot,name,role,tabindex) ona aittir.xu-teleportalt öğelerini başka bir DOM hedefinde oluşturur (toveyaxu-exp:to).- Büyük harfle başlayan bir etiket adı (
Button,Card) bir HTML öğesi değil, derlenmiş bir bileşendir; aşağıdaki Gömme bölümüne bakın.
Bileşenler
Bir bileşen (menuType: "component") bir arayüz birimidir: yerel duruma (progFields) bağlı bir öğe
ağacı (progUi), isteğe bağlı veri (progDataSource), yaşam döngüsü mantığı (progEvents) ve bir
girdi/çıktı arayüzü (properties.progParams).
Özellikler
renderType, tek bir kayıt içinform(kök öğexu-single-view) ya da her veri satırı için bir kez tekrarlanangrid/list(kök öğexu-multi-view) değeridir.rwMode, okuma içinRveya güncelleme içinUdeğeridir;allowCreate, hiçbiri eşleşmediğinde yeni bir satırın eklenip eklenemeyeceğini söyler.progParamsadlandırma kuralı: parametreler_in/_outile biter, bileşene yerel sanal alanlar_vile biter.uiFramework, projenin mevcut bileşenlerinin zaten kullandığını yansıtır. Bunu atlayan mevcut bir proje atlamaya devam etmelidir; projenin sürücüsünün gerçekte sunmadığı bir çatı eklentisi ayarlamak, canlı önizlemeyi boş bir ekranda durdurur.
Öğe ağacı (progUi)
Fabrikanın root düğümü kalır; bir derleme onun children alanının içinde çalışır. Her düğümün benzersiz
bir kimliği (yeni düğümler ui-<uuid> kullanır), type: "element" değeri ve bir tagName değeri olmalı;
comment ya da text düğüm türleri yoktur, statik metin bunun yerine content içinde yaşar. Her
düğümün, boş olsa bile, attributes: {} ve children: [] alanlarına ihtiyacı vardır; tasarımcı
tuvali serileştiricisi her düğümde ikisine de başvurur ve bir eksiklik bileşenin kendi önizlemesini bozar.
Gömme: xu-panel veya derlenmiş bir bileşen
İkisi de şeffaf şekilde bağlanır, sarmalayıcı öğe yoktur ve ikisi de tek bir sinyalle belirlenir:
tagName değerinin büyük harfle başlayıp başlamadığı.
xu-panel, küçük harflitagNameartı birprogramözniteliği, başka bir progu gömer; kendi alanları ve olayları olan, veritabanına bağlı ya da durumlu bir alt öğe.programalt öğenin kimliğidir (dinamik biri içinxu-exp:prog), değerler_inparametrelerinexu-exp:<param>ile ulaşır.- Büyük harfli bir etiket artı bir
libraryözniteliği, derlenmiş bir bileşeni bağlar; bir tasarım sistemi ilkeli ya da uygulamanın kendi derlediği bir parça. Her düz öznitelik bir prop olur (props.<name>), asla bir DOM özniteliği olmaz; çünkü bileşen kendi öğesini oluşturmaz. Bir bileşen düğümünün çıkış parametresi yoktur;xu-panel'den farklı olarak hiçbir şey alanlarınıza değer yazmaz.
Yazım hatalı bir <Buton> yine de bir bileşen etiketi olarak sahiplenilir, asla bilinmeyen bir HTML
öğesine geri dönmez ve bağlama sırasında etiketi, kitaplığı ve denenen her kaynağı adlandırarak hata
atar. validate_prog bugün bileşen etiketlerini ya da library değerlerini denetlemez; tek denetim
canlı önizlemedir.
progFields
data.type, yerel durum için virtual, bağlı veri kaynağının bir sütunu için table ya da
expression / datasource değeridir. Bir alanın workflow değeri değişimde çalışır. Varsayılan,
props.fieldValue ayarlar; hesaplanan bir alan props.fieldComputed: true ile birlikte
propExpressions.fieldValue ayarlar.
progDataSource
Anahtarla tek bir kayıt (form): tablonun kendi tableIndexes değerinde var olan bir dataSourceIndexId
ile dataSourceFilterModelType: "index". Filtrelenmiş bir liste (grid veya list):
Mongo tarzı bir ifade dizesi olan filterModelMongoFx ile dataSourceFilterModelType: "query".
dataSourceType, table, array, json, csv, none değerlerinden biridir ya da hiç veri kaynağı
olmayan, tamamen sunumsal bir bileşen için boştur.
progEvents ve üç yaşam döngüsü kancası
Olay türleri: on_load, on_exit, before_record, after_record, record_not_found,
locate_not_found, screen_ready, on_refresh, on_unload, client_interval, user_defined.
user_defined olayları, raise_event eylemiyle her yerden tetiklenir; screen_ready olağan bağlama
kancasıdır.
Bir bileşenin üç yerleşik kancası işi böler; yanlış olanı kullanmak yaygın bir hata kaynağıdır:
screen_ready
Örnek başına bir kez tetiklenir. DOM'u ve pencere öğelerini burada oluşturun.
on_refresh
İlki dahil her yüklemeden sonra, screen_ready hemen ardından tetiklenir. Yeni veriyi zaten var olan
pencere öğelerine verin. Yenileme işini bunun yerine screen_ready içine koymak, oluşturma kodunu hâlâ
var olan DOM'a karşı yeniden çalıştırır ve ikinci bir pencere öğesi üst üste bindirir.
on_unload
Örnek yıkıldığında tetiklenir. Progun oluşturduğu şeyleri yok edin: pencere öğeleri, zamanlayıcılar,
document / window dinleyicileri, gözlemciler. Motor yalnızca kendi oluşturduğunu serbest
bırakabilir; aksi halde document'a bağlı bir dinleyici panelden uzun yaşar.
Kalıplar
- Yükleme ve boş durumlar: veriye bağlı öğeye
xu-ref="myref"koyun, ardından iskelet ya da boş öğeleri(@SYS_GLOBAL_OBJ_REFS).myrefüzerindexu-renderile sınırlayın; veri geldiğinde veri kümesi eklenir. - Modallar: iletişim kutusunu kendi bileşeni olarak oluşturun,
call_modaleylemiyle açın. - Bağlı bir satırı kaydetme veya silme:
act_save/act_deleteileinvoke_actionya da geçerli satırın ötesindeki her şey için özel birset_dataprogu.
Mantık programları ve iş akışları
Mantık prog türleri, hiçbir arayüz olmadan bir bileşenin veri mekanizmasını (progDataSource,
progFields, progEvents, properties.progParams) paylaşır:
Parametreler
Bir çağıran, değerleri eylemin name.parameters alanı üzerinden geçirir,
{ "order_id_in": { "value": "", "fx": "@selected_id_v" } }; statik bir değer için value, bir ifade
için fx. Denetleyici hedef programın var olduğunu ve menuType değerinin eylemle eşleştiğini
doğrular.
İş akışı eylemleri
Bir iş akışı, sırayla çalışan adımlardan oluşan bir dizidir, { "id": "...", "data": { "action": "...", "name": { ... }, "enabled": true }, "props": {} }. props.condition bir adımı sınırlar, props.async: true onu beklemeden tetikler. İş akışları xu-on:* işleyicilerinde, progEvents[].workflow içinde ve
bir alanın kendi workflow değerinde görünür.
invoke_action, act_next, act_prev, act_first, act_last, act_reload, act_refresh,
act_print, act_save, act_delete değerlerini kabul eder (yalnızca bileşen bağlamında).
alter_ui_element, create_ui_element, info_ui_element, remove_ui_element,
empty_ui_element, cache_ui_element, load_ui_element. Arayüzü, zorunlu bir öğe eylemi yerine
alanlar ve xu-exp / xu-render ile yönlendirin.
Studio'nun kendi eylem seçicisi, yukarıdaki eylemlerin yanında AI ajanını çağır ve Triyaj
ajanını çağır seçeneklerini sunar. Hiçbiri bu tabloda yok, çünkü hiçbiri gerçek bir eylem değil:
validate_prog bunlar için bir duruma sahip değildir ve invalid trigger type bildirir; çalışma
zamanı iş akışı motorunun da bunlar için işleyicisi yoktur, bu yüzden hata yok sayılsa bile kaydedilmiş
bir adım asla çalışmaz. Bir progun yayımlanmış bir ajana ulaşmasını sağlamak için, bunun yerine başka bir
ajanın kendi araç listesine bir AI Ajanı aracı ekleyin (bir menuType: "ai_agent" belgesinin
agentConfig.agent_tools alanı); bir bileşendeki, get_data ya da başka herhangi bir prog türündeki
iş akışı adımı olarak değil.
update'in name.value değeri, alanları noktalı virgülle ayrılmış @field: expression çiftleriyle ya
da bir JSON5 nesnesiyle atar, "@saving_v: true; @status_v: 'sent'". Başka bir programı çağırmak onu
name.prog altında adlandırır ve eylemi progun kendi türüyle eşleştirir (get_data bir get_data
progu, call_native_javascript bir javascript progu gerektirir, vb.).
call_library kurulu bir eklenti yöntemini çağırır: name.plugin_name uygulamaya satın alınmış ve
kurulmuş olmalıdır, yoksa denetleyici adımı reddeder; name.library_method eklentinin dışa aktardığı
yöntemlerden biri, name.library_props bildirilen alanlarıdır. İki prop adı, herhangi birine özgü olmaktan
çok eklentiler arasında bir kuraldır: event_name_for_successful_callback o olayı yöntemin yanıtıyla
tetikler, field_id_to_return_result yanıtı doğrudan o alana yazar; ikisi de zorunlu değildir.
progEvents türleri
on_load, on_exit, before_record, after_record, record_not_found, locate_not_found,
screen_ready, on_refresh, on_unload, client_interval, user_defined. screen_ready olağan
başlatma kancasıdır; before_record / after_record /
record_not_found / locate_not_found veri yaşam döngüsüdür, özellikle set_data ve batch için;
client_interval tekrarlayan bir zamanlayıcıdır; user_defined, raise_event eyleminden tetiklenir.
Tablolar
Bir tablo progu (menuType: "table") bir veritabanı tablosunu tanımlar: sütunlarını (tableFields),
dizinlerini (tableIndexes) ve onu depolayan veritabanı eklentisini (properties.databaseSocket). Ağaç
üst öğesi: database ya da altındaki bir klasör.
databaseSocket, projeye kurulu bir veritabanı eklentisini adlandırmalıdır,@xuda.io/xuda-dbs-plugin-xudaplatform varsayılanıdır; aynı projedeki mevcut bir tablo, hangi soketin yeniden kullanılacağı için başvurudur.- En az bir alan ve en az bir dizin gereklidir.
field_idbir harfle başlar, ardından harfler, rakamlar, alt çizgi, tire, iki nokta veya nokta gelir ve tablo içinde benzersiz kalır.fieldType,string,number,boolean,array,objectveyadatedeğerlerinden biridir;mandatory: truekayıtta onu zorunlu kılar.- Her dizinin boş olmayan bir
namevekeysdeğeri olmalı ve her anahtar mevcut birfield_idolmalıdır.
Kural: sütunlara üç harfli bir tablo koduyla önek verin; "ORD - Orders" adlı bir tablo ORD_Id,
ORD_Total, ORD_Status alır. Her tabloya benzersiz bir dizinle birlikte benzersiz bir <TBL>_Id alanı
verin; tek kayıtlı bir bileşen bağlaması buna ihtiyaç duyar.
Bir tablo üç şekilde kullanılır: bir bileşenin ya da sorgunun progDataSource.dataSourceTableId değeri,
iş akışlarından satır düzeyinde erişim için bir get_data / set_data / batch progu ya da bir
betikten xu.dbs_create / dbs_read / dbs_update / dbs_delete; bu sonuncusu sırada.
JavaScript programları
Bir javascript progu (menuType: "javascript"), kayıtta derlenen gerçek JS kaynağını scriptData.value
içinde tutar. save_prog bu derlemeyi tetikler ve sonucu data.compile olarak döndürür, { ok: true, dependencies } ya da { ok: false, error }. Başarısız bir derleme yine de belgeyi kaydeder; bu yüzden
bir derleme compile.ok değerini okur ve devam etmeden önce düzeltir.
Yürütme sözleşmesi
Kaynak düz bir async gövde olarak yazılır, export yok, sarmalayıcı yok. Çalışma zamanında şöyle
yürütülür:
params çağıranın zaten değerlendirilmiş girdileridir; xu aşağıdaki çalışma zamanı API'sidir; bir
dönüş değeri isteğe bağlıdır, sonuçları geri vermenin deyimsel yolu çağıran bileşenin alanlarında
xu.set_field_value kullanmaktır. Burada tırnaklar sorun değildir; bir xu-script öznitelik değerinden
farklı olarak.
xu çalışma zamanı API'si
dbs_* yöntemleri tablo progunun kendi _id değerini alır, asla bir ad almaz. Seçiciler alan
kimlikleri üzerinde Mongo tarzı nesnelerdir, {} her şeyi döndürür (varsayılan sınır 999). fields izdüşümü isteğe bağlıdır, [] tüm alanları döndürür, alan kimliklerinden oluşan bir liste ise yalnızca o alanları döndürür.
Veriyi içeri geçirme: parametreler değil, alanlar
call_native_javascript, {value, fx} parametre sarmalayıcılarını değerlendirmez, name.parameters
betiğe ham olarak ulaşır. Güvenilir sözleşme: bileşen yükü önce bir alana koyar (bir update adımı ya da
bir xu-bind girdisi), iş akışı progu boş parameters: {} ile çağırır ve betik bunu xu.get_field_value
ile okuyup xu.set_field_value ile geri bildirir. Bunun yerine başka bir betikten çağırırken,
xu.call_javascript(prog_id, {...}) parametreleri doğrudan geçirir.
Canlı önizleme tuhaflıkları
- Veri yazmaları gerçek veritabanına ulaşır, ancak
xu.dbs_readtaze sunucu satırlarını tutmayabilen yerel bir taslak deposunu okur; bir yazmadan hemen sonraki okuma, yazma tamamlanmış olsa bile önizlemede boş dönebilir (Studio'da tablonun Veri sekmesinde görünür). Dağıtılmış uygulamalar aynı depoyu okur ve yazar. - Derlenmiş betikler geliştirme önizlemelerinde sert şekilde önbelleğe alınır; çalışan bir önizleme, bir kayıt onu yeniden derledikten sonra yeniden yüklemelerde bile önceki betiği çalıştırmaya devam edebilir. Sert bir tarayıcı yenilemesi bunu temizler.
modal,toastveyabrowsergösterimlixu.alert, önizlemede yerel, engelleyici biralert()olarak ortaya çıkabilir. Bir durum alanınaxu.set_field_valueyazmak geri bildirmenin daha güvenli yoludur.
javascript progu ile xu-script özniteliği
xu-script / xu-style için tırnaksız teknikler
Tasarımcı tuvali öznitelik değerlerini kaçışsız serileştirir; bu yüzden tek bir tırnak bileşenin
işaretlemesini bozar. Şablon değişmezleri dize tırnaklarını tamamen önler
(el.textContent = `Ready`); örneğin CSV oluştururken değişmez " karakteri
String.fromCharCode(34) ile gelir; CSS öznitelik seçicileri tırnaksız da geçerlidir
(el.querySelector(`[data-role=import-btn]`)); ve bir yeniden çalışma koruması,
if (el.__bound) return; el.__bound = true;, bir betiği yeniden oluşturmada çift bağlanmaktan korur.
Tuzaklar
Aşağıdaki her girdi bir noktada gerçek bir derlemeyi bozmuştur. validate_prog çoğunu yakalar; her
kayıttan önce çalıştırın.
API mekaniği
- Her yanıt
{ code, data }biçimindedir,code < 0bir hatadır. create_progyeni belgeyidata.progaltında döndürür; tüm yanıtı kaydetmek,propertiesdeğeriprogaltına gömülmüş hatalı biçimli bir belgeyi kalıcı kılar.save_progtüm belgeyi değiştirir. Daima mevcut belgeden başlayın, asla elle derlenmiş bir iskeletten değil;-409, son okumadan beri değiştiği anlamına gelir: yeniden getirin, yeniden uygulayın, yeniden deneyin.- MCP üzerinden
prog_jsonveproperties_jsondize olarak geçirilir; araç şeması katmanı bir nesne parametresindeki bilinmeyen anahtarları ayıklar ve tüm bölümleri sessizce düşürebilir. delete_progyumuşak bir silmedir,stat: 4ayarlar.global_<app_id>düğümü silinemez.
Belge içeriği
xu-scriptveyaxu-styledeğerlerinin içinde'ya da"olmaz.$önekli anahtarlar ($folded,$childrenClass,$nodeBackClass) ilepath,code,editCodetasarımcı görünüm durumudur ve kaydedilmiş birprogUidüğümüne asla ait değildir.commentveyatextdüğüm türleri yok, yalnızca öğeler, statik metincontentiçinde.- Her öğe düğümü, boş olsa bile,
attributes: {}vechildren: []gerektirir. xu-exp:classstatikclassdeğerini değiştirir, gereken her sınıf ifadenin içine aittir.xu-bindyalın bir alan kimliğidir,@yok; başka her yerde alanlar@kullanır.- Yalnızca belgelenmiş
xu-*öznitelikleri bir şey yapar; uydurulmuş biri sessizce yok sayılır vevalidate_proguyarır. - Bir
ai_agentprogunun ağaç köküai_agents'tir; denetleyiciparentIddeğerini işaretlerse onustudio_meta.parentId: "ai_agents"(veya altındaki bir klasör kimliği) ile kaydedin.
Çalışma zamanı ve oluşturma
- Büyük harfli bir
tagNameher zaman bir bileşen olarak sahiplenilir, yazım hatası olsa bile, ve bağlama sırasında etiketi,librarydeğerini ve denenen her kaynağı adlandırarak hata atar; program seçilmemiş birxu-panel'deki gibi sessiz bir "oluşturulmuyor" durumu yoktur. validate_progbileşen etiketlerini ya dalibrarydeğerlerini denetlemez; yanlış yazılmış birini yalnızca canlı önizleme yakalar.- Projenin
uiFrameworkeklentisi gerçekten sağlamıyorsa çalışma zamanında yardımcı CSS (Tailwind ya da başka) yoktur;p-4gibi sınıflar aksi halde sessizce etkisiz kalır. Kendi içinde yeterli stil,[xu-ui-id]ile otomatik kapsamlananxu-styleile yapılır. xu-scriptöğe görünürlüğü başına bir kez çalışır ve yeniden oluşturmada yeniden tetiklenebilir;el.__boundile koruyun ve sorgularıelile sınırlayın.
Veri ve betikler
call_native_javascriptparametreleri değerlendirilmez, veriyi bunun yerine alanlar üzerinden geçirin (yukarıdaki Veriyi içeri geçirme bölümüne bakın).dbs_readsatırları{id, value}biçimindedir, alanlar.valuealtında, satır kimliği.idüzerinde yaşar. Birfieldsizdüşümü geçirmeyin, sunucu tarafı okumayı bozar.xu-foriçinde yineleyiciyi parantezle sarın,(@_FOR_VAL).CNT_Namedeğerlendirilir,@_FOR_VAL.CNT_Namesessizce başarısız olur ve bunun yerine yerine konan kaynak metni oluşturur.- Önizleme yazmaları gerçek veritabanına ulaşır; önizleme okumaları, bir yazmadan hemen sonra boş görünebilen yerel bir taslak deposundan gelir.
- Önizlemelerde
xu.alert'in modal veya toast gösterimi yerine bir durum alanını tercih edin; yerel, engelleyici biralert()olarak oluşturulabilir.
Çalışmanızı doğrulama
Kaydettikten sonra get_prog ile yeniden getirin ve beklenenle farkı karşılaştırın. Arayüz işi için
bileşeni Studio'da açıp önizleme oynat düğmesine ya da varsa projenin canlı önizleme URL'sine basın.
Bir javascript progu için her kayıtta data.compile.ok değerini kontrol edin. Her validate_prog
hatasını düzeltin; uyarılarını, tırnakları, $ anahtarlarını, bilinmeyen öznitelikleri, gürültü
olarak değil, şimdi düzeltilecek öğeler olarak ele alın.