Studion LLM-opas
Prog-dokumenttimalli, xu-*-attribuuttiviite ja työnkulun säännöt, jotka tekoälyagentille opetetaan ennen sen ensimmäistä työkalukutsua.
Jokainen Studio-projekti, ja sen sisällä jokainen taulu, näkymä, skripti ja reitti, on yksi CouchDB
JSON -dokumentti nimeltä prog (docType: "studio"). Tämä sivu on sama viite, jonka tekoälyagentti
saa rakentaessaan sellaista, kirjoitettuna dokumentaatioksi: dokumentin muoto, sen käyttöliittymää
ohjaavat attribuutit, toiminnot, joita työnkulku voi tehdä, ja virheet, jotka toistuvat oikeissa
rakennuksissa.
Miten tekoälyagentti saa tämän oppaan
Yhdistä MCP-asiakas Xudaan, niin ensimmäinen vastaus, initialize-kutsu, kantaa tämän oppaan
istunnon instructions-kentässä, yhdistettynä tuoreeltaan alustan omista elävistä säännöistä, jotta
se ei voi koskaan kuvata jotain, jota julkaistu tarkistin ei enää valvo. Katso
AI-asiakkaan yhdistäminen MCP:llä.
Istunnon sisältä kaksi metodia tavoittaa saman aineiston suoraan, MCP:n tai tavallisen REST:n yli, eivätkä vaadi muuta kuin tavallisen API-avaimen:
Määrätty järjestys: lue rakennettavaa vastaava aihe, hae vastaava esimerkki, luo prog tehtaan kautta
(create_prog), rakenna sen sisältöosioiden sisällä, validoi (validate_prog) ja korjaa kaikki,
mitä se raportoi, tallenna (save_prog) ja hae sitten uudelleen varmistaaksesi. Tallennus, joka
palauttaa -409, tarkoittaa, että dokumentti on muuttunut lukemisen jälkeen: hae uudelleen, sovella
muutokset uudelleen, yritä uudelleen.
Prog-dokumenttimalli
Kirjekuori
Palvelin- ja tehdaskoodi omistavat nämä kentät, kirjoitettu rakennus muokkaa vain niiden alla olevia sisältöosioita.
_idnoudattaa muotoa<app_id:n viimeiset 3 merkkiä>_<3-kirjaiminen tyyppilyhenne>_<12 heksaa>, esimerkiksi392_cmp_...komponentille,392_tbl_...taululle,392_jvs_...javascript-progille,392_gtd_.../392_std_...get_data- / set_data-progille,392_fld_...kansiolle. Tehdas generoi tunnisteet, rakennus ei koskaan keksi sellaista.staton 3 aktiiviselle ja 4 pehmeästi poistetulle (sen asettaa progin poistaminen). Studion puu näyttää vainstat: 3.properties.menuTypeon yksi arvoistaglobals,table,get_data,set_data,batch,alert,javascript,folder,route,api,component,ai_agent.studio_meta.parentIdsijoittaa solmun Studion puuhun: joko toisen progin tunniste (yleensä kansio) tai yksi tyyppijuurista,programs(logiikka ja komponentit),database(taulut),routes,globals,ai_agents. TunnistamatonparentIdjättää solmun näkymättömäksi puussa ja on tarkistusvirhe.
Sisältöosiot menuType-arvon mukaan
Globals-dokumentti
Jokaisella projektilla on täsmälleen yksi global_<app_id>-dokumentti (menuType: "globals"). Sen
progFields ovat luettavissa jokaisesta muusta progista muodossa @field_id. Kaksi järjestelmän
globaalia kuuluu jokaiseen projektiin: @SYS_GLOBAL_OBJ_LOGIN_USER_INFO kirjautuneelle käyttäjälle
ja @SYS_GLOBAL_OBJ_REFS elementeille, jotka on rekisteröity xu-ref:llä. Globals-dokumenttia
eikä puun juurta voi poistaa.
Rakenteelliset pakolliset
properties,properties.menuType,properties.menuName,studio_metajastudio_meta.parentIdovat pakollisia jokaisessa dokumentissa.progFields-merkintä tarvitsee yksilöllisenid:n,data.field_id:n,data.type:n arvoltaanvirtual,table,expressiontaidatasourcejaprops.fieldType:n arvoltaanstring,number,boolean,arraytaiobject.- Varattuja suoritusaikaisia muuttujanimiä,
_NULL,_THIS,_FOR_KEY,_FOR_VAL,_ROWNO,_ROWID,_ROWDOC,_KEY,_VAL, ei koskaan määritellä uudelleen kenttätunnisteina. - Päällekkäiset tunnisteet, tuntemattomat
menuType-arvot ja virheelliset osiot ovat kaikki kovia virheitä, jotkavalidate_prograportoi suoraan.
Lausekkeet ja xu-*-attribuutit
Lausekesyntaksi
Lausekkeet ajetaan progin oman datajoukon päällä. Mihin tahansa kenttään, paikalliseen,
taulusidonnaiseen, globaaliin tai parametriin, viitataan @:lla: @search_v, @ORD_Total,
@SYS_GLOBAL_OBJ_LOGIN_USER_INFO, tavallista JavaScriptiä sen ympärillä,
@count_v > 0 ? 'has rows' : 'empty'. Olioliteraali tarvitsee ympärilleen sulkeet,
({ ORD_Status: @status_v }). xu-for-silmukan sisällä nykyinen kohde on @_FOR_VAL ja sen avain
tai indeksi @_FOR_KEY (uudelleennimettävissä xu-for-key / xu-for-val -attribuuteilla).
xu-render ja muut ehdot palauttavat tosi- tai epätosi-arvon suoraan, ei koskaan "Y" / "N"
-merkkijonoa tai ylimääräistä vertailua.
Kaikkialla muualla kenttään viitataan @:lla. xu-bind ottaa sen sijaan pelkän kenttätunnisteen:
xu-bind="search_v", ei koskaan xu-bind="@search_v".
xu-attribuutit
Etuliiteperheet
Attribuuttiperheet, jotka ottavat päätteen. xu-on-arvot ovat aina taulukoita käsittelijäolioita,
xu-exp-arvot ovat aina lausekemerkkijonoja.
xu-on:*-attribuutin arvo on aina taulukko käsittelijäolioita, ja kukin workflow on taulukko
toimintoaskeleita (täysi toimintoviite on alla kohdassa Logiikkaprogit ja työnkulut). Askeleen
props.condition rajaa sen, props.async: true laukaisee sen odottamatta.
Kriittiset semantiikat
xu-exp:classkorvaa staattisenclass-attribuutin sen sijaan, että lisäisi siihen. Elementillä, jolla on molemmat, staattinen ohitetaan, joten asettelun luokat kuuluvat myös lausekkeen sisään:xu-exp:class="'card p-4 ' + (@active_v ? 'ring' : '')".xu-scriptottaa pelkänfunction (el) { ... }-lausekkeen, jokaeval-ajetaan ja kutsutaan DOM-elementillä, kun solmu tulee näkyviin. Suojaudu uudelleenajoilta (if (el.__bound) return; el.__bound = true;) ja rajaa jokainen kyselyel:iin, ei koskaandocument:iin.xu-styleon automaattisesti rajattu: jokaiseen valitsimeen lisätään etuliitteeksi solmun[xu-ui-id], joten tavalliset elementti- ja luokkavalitsimet pysyvät paikallisina eivätkä vuoda.- Kumpikaan
xu-script- taixu-style-arvo ei saa sisältää lainausmerkkiä ('tai"): suunnittelukanvas sarjallistaa attribuutit ilman escapeja, ja yksi lainausmerkki turmelee komponentin. Alla oleva JavaScript-progit-osio käsittelee lainausmerkittömiä tekniikoita. - Staattinen teksti kuuluu elementin
content-ominaisuuteen.xu-exp:xu-contenton vain dynaamista tekstiä varten.
Tagit
Kirjoitustagit tavallisen HTML:n lisäksi: xu-template, xu-single-view, xu-multi-view,
xu-panel, xu-teleport, xu-slot.
xu-single-viewrajaa yksittäisen tietueen (lomakkeen juuri, käytettävissä myös sisäkkäin).xu-multi-viewtoistaa lapsensa kerran sidotun datan jokaista riviä kohden.xu-panelupottaa toisen progin (program-attribuutti sekäxu-exp:<param>-syötteet). Siihen kuuluvat parametrilausekkeiden lisäksi vain tavalliset HTML-attribuutit (class,id,style,title,hidden,slot,name,role,tabindex).xu-teleportrenderöi lapsensa toiseen DOM-kohteeseen (totaixu-exp:to).- Isolla alkukirjaimella kirjoitettu tagin nimi (
Button,Card) on käännetty komponentti, ei HTML-elementti, katso alla Upottaminen.
Komponentit
Komponentti (menuType: "component") on käyttöliittymäyksikkö: elementtipuu (progUi), joka on
sidottu paikalliseen tilaan (progFields), valinnaiseen dataan (progDataSource),
elinkaarilogiikkaan (progEvents) ja syöte-/tulostekäyttöliittymään (properties.progParams).
Ominaisuudet
renderTypeonformyhdelle tietueelle (juurielementtixu-single-view) taigrid/listyhdelle toistetulle datariviä kohden (juurielementtixu-multi-view).rwModeonRlukemiselle taiUpäivitykselle,allowCreatekertoo, voiko uuden rivin lisätä, kun mikään ei täsmää.progParams-nimeämiskäytäntö: parametrit päättyvät_in/_out, komponentin paikalliset virtuaalikentät päättyvät_v.uiFrameworkpeilaa sitä, mitä projektin olemassa olevat komponentit jo käyttävät. Olemassa oleva projekti, joka jättää sen pois, jättää sen jatkossakin pois: kehysliitännäisen asettaminen, jota projektin drive ei oikeasti tarjoa, jumittaa live-esikatselun tyhjälle näytölle.
Elementtipuu (progUi)
Tehtaan root-solmu pysyy, rakennus työskentelee sen children-kentän sisällä. Jokainen solmu
tarvitsee yksilöllisen tunnisteen (uudet solmut käyttävät ui-<uuid>), type: "element" ja
tagName:n, ei comment- tai text-solmutyyppejä, staattinen teksti on content-kentässä.
Jokainen solmu tarvitsee attributes: {} ja children: [] vaikka tyhjänä: suunnittelukanvaksen
sarjallistaja viittaa molempiin jokaisella solmulla, ja puute rikkoo komponentin oman esikatselun.
Upottaminen: xu-panel vai käännetty komponentti
Molemmat liitetään läpinäkyvästi ilman kääreelementtiä, ja molemmat ratkaistaan yhdellä signaalilla:
alkaako tagName isolla kirjaimella.
xu-panel, pienellä kirjoitettutagNamesekäprogram-attribuutti, upottaa toisen progin, tietokantasidonnaisen tai tilallisen lapsen omine kenttineen ja tapahtumineen.programon lapsen tunniste (taixu-exp:progdynaamiselle), arvot saavuttavat sen_in-parametritxu-exp:<param>:n kautta.- Isolla alkukirjaimella kirjoitettu tagi sekä
library-attribuutti liittää käännetyn komponentin, suunnittelujärjestelmän primitiivin tai sovelluksen itse kääntämän osan. Jokaisesta tavallisesta attribuutista tulee prop (props.<name>), ei koskaan DOM-attribuutti, koska komponentti ei renderöi omaa elementtiä. Komponenttisolmulla ei ole out-parametreja: toisin kuinxu-panel, mikään ei kirjoita arvoa takaisin kentillesi.
Kirjoitusvirheellinen <Buton> tulkitaan yhä komponenttitagiksi, ei koskaan putoa takaisin
tuntemattomaksi HTML-elementiksi, ja heittää liitettäessä virheen, joka nimeää tagin, kirjaston ja
jokaisen kokeillun lähteen. validate_prog ei tarkista komponenttitageja eikä library-arvoja
nykyisin, live-esikatselu on ainoa tarkistus.
progFields
data.type on virtual paikalliselle tilalle, table sidotun datalähteen sarakkeelle tai
expression / datasource. Kentän workflow ajetaan muutoksessa. Oletusarvo asettaa
props.fieldValue:n, laskettu kenttä asettaa props.fieldComputed: true sekä
propExpressions.fieldValue:n.
progDataSource
Yksi tietue avaimella (lomake): dataSourceFilterModelType: "index" ja dataSourceIndexId, joka on
olemassa taulun omassa tableIndexes-kentässä. Suodatettu lista (grid tai list):
dataSourceFilterModelType: "query" ja filterModelMongoFx, Mongo-tyylinen lausekemerkkijono.
dataSourceType on table, array, json, csv, none tai tyhjä puhtaasti esittävälle
komponentille, jolla ei ole lainkaan datalähdettä.
progEvents ja kolme elinkaarikoukkua
Tapahtumatyypit: 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-tapahtumat laukeavat mistä tahansa raise_event-toiminnolla, screen_ready on
tavallinen liitoskoukku.
Komponentin kolme sisäänrakennettua koukkua jakavat työn, ja väärän käyttö on yleinen virheiden lähde:
screen_ready
Laukeaa kerran instanssia kohden. Luo DOM ja widgetit täällä.
on_refresh
Laukeaa jokaisen latauksen jälkeen, myös ensimmäisen, heti screen_ready:n jälkeen. Anna uusi data
widgeteille, jotka jo ovat olemassa. Jos päivitystyö laitetaan sen sijaan screen_ready:iin, luontikoodi
ajetaan uudelleen DOMia vasten, joka yhä on olemassa, ja pinoaa toisen widgetin.
on_unload
Laukeaa, kun instanssi puretaan. Tuhoa se, minkä prog loi: widgetit, ajastimet,
document / window -kuuntelijat, tarkkailijat. Moottori voi vapauttaa vain sen, minkä se loi:
document:iin sidottu kuuntelija elää muuten paneelin yli.
Mallit
- Lataus- ja tyhjätilat: aseta
xu-ref="myref"datasidotulle elementille ja rajaa sitten luuranko- tai tyhjäelementitxu-render:llä lausekkeella(@SYS_GLOBAL_OBJ_REFS).myref, sen datajoukko liittyy, kun data saapuu. - Modaalit: rakenna dialogi omana komponenttinaan ja avaa se
call_modal-toiminnolla. - Sidotun rivin tallennus tai poisto:
invoke_actionarvollaact_save/act_deletetai omaset_data-prog kaikelle nykyistä riviä laajemmalle.
Logiikkaprogit ja työnkulut
Logiikkaprog-tyypit jakavat komponentin datakoneiston (progDataSource, progFields,
progEvents, properties.progParams) ilman käyttöliittymää:
Parametrit
Kutsuja välittää arvot toiminnon name.parameters-kentän kautta,
{ "order_id_in": { "value": "", "fx": "@selected_id_v" } }, value staattiselle arvolle, fx
lausekkeelle. Tarkistin varmistaa, että kohdeohjelma on olemassa ja sen menuType vastaa
toimintoa.
Työnkulun toiminnot
Työnkulku on taulukko askeleita, { "id": "...", "data": { "action": "...", "name": { ... }, "enabled": true }, "props": {} }, ajettuna järjestyksessä. props.condition rajaa askeleen,
props.async: true laukaisee sen odottamatta. Työnkulut esiintyvät xu-on:*-käsittelijöissä,
progEvents[].workflow:ssa ja kentän omassa workflow:ssa.
invoke_action hyväksyy arvot act_next, act_prev, act_first, act_last, act_reload,
act_refresh, act_print, act_save, act_delete (vain komponenttikontekstissa).
alter_ui_element, create_ui_element, info_ui_element, remove_ui_element,
empty_ui_element, cache_ui_element, load_ui_element. Ohjaa käyttöliittymää kenttien ja
xu-exp / xu-render:in kautta imperatiivisen elementtitoiminnon sijaan.
Studion oma toimintovalitsin tarjoaa Kutsu tekoälyagenttia ja Kutsu triage-agenttia yllä
olevien toimintojen rinnalla. Kumpaakaan ei ole tässä taulukossa, koska kumpikaan ei ole sellainen:
validate_prog:lla ei ole niille tapausta ja se raportoi invalid trigger type, eikä suoritusaikaisella
työnkulkumoottorilla ole niille käsittelijää, joten tallennettu askel ei koskaan aja, vaikka virhe
ohitettaisiin. Jotta yksi prog tavoittaisi julkaistun agentin, lisää Tekoälyagentti-työkalu toisen
agentin omaan työkaluluetteloon (menuType: "ai_agent"-dokumentin agentConfig.agent_tools),
älä työnkulun askeleena komponentissa, get_data:ssa tai missään muussa prog-tyypissä.
update:n name.value antaa kentille arvoja puolipisteellä erotetuilla @field: expression
-pareilla tai JSON5-oliolla, "@saving_v: true; @status_v: 'sent'". Toisen ohjelman kutsuminen
nimeää sen kohdassa name.prog, ja toiminto täsmätään progin omaan tyyppiin (get_data tarvitsee
get_data-progin, call_native_javascript javascript-progin ja niin edelleen).
call_library kutsuu asennetun liitännäisen metodia: name.plugin_name täytyy olla ostettu ja
asennettu sovellukseen tai tarkistin hylkää askeleen, name.library_method yksi liitännäisen
viemistä metodeista, name.library_props sen ilmoitetut kentät. Kaksi prop-nimeä on käytäntö
liitännäisten kesken eikä minkään yksittäisen erityinen: event_name_for_successful_callback
nostaa kyseisen tapahtuman metodin vastauksella, field_id_to_return_result kirjoittaa vastauksen
suoraan kyseiseen kenttään, kumpikaan ei ole pakollinen.
progEvents-tyypit
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 on
tavallinen alustuskoukku, before_record / after_record /
record_not_found / locate_not_found ovat datan elinkaarta, erityisesti set_data:lle ja
batch:lle, client_interval on toistuva ajastin, user_defined laukeaa raise_event-toiminnosta.
Taulut
Taulu-prog (menuType: "table") määrittelee tietokantataulun: sen sarakkeet (tableFields),
indeksit (tableIndexes) ja sen tallentavan tietokantaliitännäisen (properties.databaseSocket).
Puun vanhempi: database tai sen alla oleva kansio.
databaseSocket:n täytyy nimetä projektiin asennettu tietokantaliitännäinen,@xuda.io/xuda-dbs-plugin-xudaon alustan oletus, saman projektin olemassa oleva taulu on viite siitä, mitä socketia käyttää uudelleen.- Vähintään yksi kenttä ja vähintään yksi indeksi vaaditaan.
field_idalkaa kirjaimella, sitten kirjaimia, numeroita, alaviiva, tavuviiva, kaksoispiste tai piste, ja on yksilöllinen taulun sisällä.fieldTypeonstring,number,boolean,array,objecttaidate,mandatory: truetekee siitä pakollisen tallennettaessa.- Jokainen indeksi tarvitsee ei-tyhjän
name:n jakeys:n, ja jokaisen avaimen täytyy olla olemassa olevafield_id.
Käytäntö: etuliitä sarakkeet kolmikirjaimisella taulukoodilla, taulu nimeltä "ORD - Orders" saa
ORD_Id, ORD_Total, ORD_Status. Anna jokaiselle taululle yksilöllinen <TBL>_Id-kenttä ja
sille yksilöllinen indeksi, yhden tietueen komponenttisidonta tarvitsee sen.
Taulua käytetään kolmella tavalla: komponentin tai kyselyn progDataSource.dataSourceTableId,
get_data / set_data / batch -prog rivitason pääsyyn työnkuluista tai xu.dbs_create /
dbs_read / dbs_update / dbs_delete skriptistä, katso seuraavaksi.
JavaScript-progit
Javascript-prog (menuType: "javascript") sisältää oikeaa JS-lähdettä kentässä scriptData.value,
käännettynä tallennettaessa. save_prog käynnistää koonnin ja palauttaa tuloksen muodossa
data.compile, { ok: true, dependencies } tai { ok: false, error }. Epäonnistunut käännös tallentaa dokumentin silti, joten
rakennus lukee compile.ok:n ja korjaa sen ennen jatkamista.
Suoritussopimus
Lähde kirjoitetaan tavallisena async-runkona, ei export:ia, ei kääretta. Ajon aikana se suoritetaan
seuraavasti:
params ovat kutsujan jo arvioidut syötteet, xu on alla oleva suoritusaikainen API, paluuarvo on
valinnainen, idiomaattinen tapa palauttaa tuloksia on xu.set_field_value kutsuvan komponentin
kentille. Lainausmerkit ovat täällä sallittuja, toisin kuin xu-script-attribuutin arvossa.
xu-suoritusaikainen API
dbs_*-metodit ottavat taulu-progin oman _id:n, ei koskaan nimeä. Valitsimet ovat Mongo-tyylisiä
olioita kenttätunnisteista, {} palauttaa kaiken (oletusraja 999). fields-projektio on valinnainen: [] palauttaa kaikki kentät, ja kenttätunnisteiden lista palauttaa vain ne.
Datan välittäminen: kentät, ei parametrit
call_native_javascript ei arvioi {value, fx}-parametrikääreitä, name.parameters saavuttaa
skriptin raakana. Luotettava sopimus: komponentti asettaa kuorman ensin kenttään (update-askel tai
xu-bind-syöte), työnkulku kutsuu progia tyhjillä parameters: {}, ja skripti lukee sen
xu.get_field_value:lla ja raportoi takaisin xu.set_field_value:lla. Kutsuttaessa sen sijaan
toisesta skriptistä, xu.call_javascript(prog_id, {...}) välittää parametrit suoraan.
Live-esikatselun oikut
- Datakirjoitukset päätyvät oikeaan tietokantaan, mutta
xu.dbs_readlukee paikallista luonnosvarastoa, jossa ei välttämättä ole tuoreita palvelimen rivejä: kirjoituksen jälkeen heti tehty luku voi palata tyhjänä esikatselussa, vaikka kirjoitus onnistui (näkyy taulun Data-välilehdellä Studiossa). Julkaistut sovellukset lukevat ja kirjoittavat samaa varastoa. - Käännetyt skriptit välimuistitetaan kovasti dev-esikatseluissa, käynnissä oleva esikatselu voi jatkaa edellisen skriptin suorittamista uudelleenlatausten yli, vaikka tallennus kääntäisi sen uudelleen. Selaimen kova päivitys tyhjentää sen.
xu.alertnäytöllämodal,toasttaibrowservoi esiintyä esikatselussa natiivina, estävänäalert():ina.xu.set_field_valuetilakenttään on turvallisempi tapa raportoida takaisin.
javascript-prog vs xu-script-attribuutti
Lainausmerkittömät tekniikat xu-script / xu-style -attribuuteille
Suunnittelukanvas sarjallistaa attribuuttiarvot ilman escapeja, joten yksi lainausmerkki turmelee
komponentin merkinnän. Template-literaalit välttävät merkkijonolainausmerkit kokonaan
(el.textContent = `Ready`), kirjaimellinen "-merkki, esimerkiksi CSV:tä rakennettaessa, tulee
String.fromCharCode(34):stä, CSS-attribuuttivalitsimet ovat kelvollisia ilman lainausmerkkejä
(el.querySelector(`[data-role=import-btn]`)) ja uudelleenajosuoja,
if (el.__bound) return; el.__bound = true;, estää skriptiä sitomasta kahdesti uudelleenrenderöinnissä.
Sudenkuopat
Jokainen alla oleva kohta rikkoi jossain vaiheessa oikean rakennuksen. validate_prog pyydystää
useimmat niistä, aja se ennen jokaista tallennusta.
API:n mekaniikka
- Jokainen vastaus on
{ code, data },code < 0on virhe. create_progpalauttaa uuden dokumentin kohdassadata.prog, koko vastauksen tallentaminen sen sijaan tallentaa virheellisen dokumentin, jossapropertieson haudattuprog:n alle.save_progkorvaa koko dokumentin. Aloita nykyisestä dokumentista, ei koskaan käsin kootusta rungosta,-409tarkoittaa, että se on muuttunut viimeisen lukemisen jälkeen: hae uudelleen, sovella uudelleen, yritä uudelleen.- MCP:n yli
prog_jsonjaproperties_jsonvälitetään merkkijonoina, työkaluskeemakerros poistaa tuntemattomat avaimet oliokentästä ja voi hiljaa pudottaa kokonaisia osioita. delete_progon pehmeä poisto, se asettaastat: 4.global_<app_id>-solmua ei voi poistaa.
Dokumentin sisältö
- Ei
'- tai"-merkkiäxu-script- taixu-style-arvojen sisällä. $-etuliitteiset avaimet ($folded,$childrenClass,$nodeBackClass) sekäpath,code,editCodeovat suunnittelijan näkymätilaa eivätkä koskaan kuulu tallennettuunprogUi-solmuun.- Ei
comment- taitext-solmutyyppejä, vain elementtejä, staattinen teksticontent-kentässä. - Jokainen elementtisolmu tarvitsee
attributes: {}jachildren: []vaikka tyhjänä. xu-exp:classkorvaa staattisenclass:n, jokainen tarvittava luokka kuuluu lausekkeen sisään.xu-bindon pelkkä kenttätunniste ilman@:a, kaikkialla muualla kentät käyttävät@:a.- Vain dokumentoidut
xu-*-attribuutit tekevät mitään, keksitty ohitetaan hiljaa javalidate_progvaroittaa. ai_agent-progin puun juuri onai_agents, tallenna se arvollastudio_meta.parentId: "ai_agents"(tai sen alla olevan kansion tunnisteella), jos tarkistin liputtaaparentId:n.
Suoritusaika ja renderöinti
- Isolla alkukirjaimella kirjoitettu
tagNametulkitaan aina komponentiksi, myös kirjoitusvirhe, ja heittää liitettäessä virheen, joka nimeää tagin,library:n ja jokaisen kokeillun lähteen, hiljaista "ei renderöidy" -tilaa ei ole, toisin kuinxu-panel:lla, jolle ei ole valittu ohjelmaa. validate_progei tarkista komponenttitageja eikälibrary-arvoja, vain live-esikatselu pyydystää väärin kirjoitetun.- Ei apuohjelma-CSS:ää (Tailwind tai muu) suoritusaikana, ellei projektin
uiFramework-liitännäinen oikeasti tarjoa sitä, luokat kutenp-4eivät muuten tee mitään. Itsenäinen tyylitys onxu-style, automaattisesti rajattu[xu-ui-id]:llä. xu-scriptajetaan kerran elementin näkyvyyttä kohden ja voi laueta uudelleen uudelleenrenderöinnissä, suojaael.__bound:lla ja rajaa kyselytel:iin.
Data ja skriptit
call_native_javascript-parametreja ei arvioida, välitä data kenttien kautta (katso yllä Datan välittäminen).dbs_read-rivit ovat{id, value}, kentät ovat kohdassa.value, rivin tunniste kohdassa.id. Älä annafields-projektiota, se rikkoo palvelinpuolen luvun.xu-for:in sisällä kääri iteraattori sulkeisiin,(@_FOR_VAL).CNT_Namearvioituu,@_FOR_VAL.CNT_Nameepäonnistuu hiljaa ja renderöi sen sijaan korvatun lähdetekstin.- Esikatselun kirjoitukset päätyvät oikeaan tietokantaan, esikatselun luvut tulevat paikallisesta luonnosvarastosta, joka voi näyttää tyhjältä heti kirjoituksen jälkeen.
- Suosi tilakenttää
xu.alert:in modal- tai toast-näytön sijaan esikatseluissa, se voi renderöityä natiivina, estävänäalert():ina.
Työn varmistaminen
Hae uudelleen get_prog:lla tallennuksen jälkeen ja vertaa odotettuun. Käyttöliittymätyössä avaa
komponentti Studiossa ja paina esikatselun toistopainiketta tai projektin live-esikatselun URL-osoitetta,
kun sellainen on saatavilla. Javascript-progille tarkista data.compile.ok jokaisella tallennuksella.
Korjaa jokainen validate_prog-virhe, käsittele sen varoitukset, lainausmerkit, $-avaimet,
tuntemattomat attribuutit, korjaa-nyt-kohteina eikä kohinana.