Component
[object Object]
Component on käyttöliittymän yksikkö: elementtipuu, joka on sidottu paikalliseen tilaan, valinnaiseen dataan, elinkaarilogiikkaan sekä syöte- ja tulosterajapintaan. Sivu, kortti, modaali-ikkuna, ponnahdusikkuna ja upotettu osa ovat kaikki Component-ohjelmia. Se on alustan monipuolisin dokumenttityyppi, koska sillä on oma käyttöliittymäpuunsa sekä kentät, tapahtumat ja datasource, jotka se jakaa kaikkien muiden ohjelmatyyppien kanssa.
Ominaisuudet
renderType (form / grid / list) on vanhentunut eikä enää pakollinen. Uudet componentit luodaan ilman sitä. Uusi Component saa sen sijaan pohjavalinnan, single tai multi, joka valitaan kerran New Component -ikkunassa: single luo paljaan xu-template-juuren, johon voi rakentaa suoraan, ja multi luo saman xu-template-juuren, jonka sisään on valmiiksi sijoitettu latausta kuvaava div ja xu-multi-view. xu-single-view on edelleen aito, itse kirjoitettava tagi, mutta tehdas ei aseta sitä puolestasi: vain siirtämätöntä vanhaa dokumenttia (juuri ei vielä xu-template) verrataan siihen, kun sen vanhentunut renderType sanoo yhä form.
progUi, elementtipuu
Juurisolmu on aina läpinäkyvä xu-template, jonka create_progin scaffold_prog_ui luo. Kun valitset multi-pohjan, sen sisään sijoitetaan puolestasi latausta kuvaava div ja xu-multi-view. single-pohja jättää sen tyhjäksi, ja rakennat suoraan sen children-kenttään. Jokaisella solmulla on oltava yksilöllinen id, type: "element", tagName sekä attributes: {} ja children: [] silloinkin, kun ne ovat tyhjiä.
Tavallisten HTML-tagien lisäksi muutama xuda-tagi kirjoitetaan suoraan: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.
Isolla alkukirjaimella kirjoitettu tagName (Button, Dialog) tulkitaan aina käännetyksi design-system-componentiksi, ei koskaan HTML-elementiksi, vaikka kyse olisi kirjoitusvirheestä: se antaa virheen liitettäessä ja nimeää tagin sekä kaikki kokeillut lähteet. Sen tavalliset attribuutit muuttuvat propseiksi, eivät DOM-attribuuteiksi (variant, color ja class saapuvat kaikki muodossa props.<name>), ja toisin kuin xu-panelilla sillä ei ole out-parametreja: componentti-tagi vain lukee sen, mitä sille annat.
Dynaaminen toiminta: xu-*-attribuutit
Kaikki xu-*-attribuutit, jotka Componentin elementtipuu voi sisältää:
Kaksi on helppo sekoittaa: xu-bind ottaa pelkän kentän tunnuksen ilman @-merkkiä, ainoa poikkeus @-sääntöön kaikkialla muualla. Lisäksi xu-exp:class korvaa staattisen class-attribuutin kokonaan, joten asettelun luokat on toistettava lausekkeen sisällä.
progFields, progEvents, progDataSource
Paikallinen tila (progFields, virtual tai table-sidottu), valinnainen upotettu Datasource ja elinkaaritapahtumat. Kolme näistä tapahtumista jakaa työn tavalla, jonka on helppo sekoittaa:
Jos päivitystyö laitetaan screen_ready-tapahtumaan, luontilogiikka ajetaan uudelleen DOM:lle, joka on yhä olemassa, ja toinen widget kasaantuu ensimmäisen päälle.
Toisen ohjelman upottaminen: xu-panel
xu-panel (pienaakkosinen tagName, program-attribuutti) liittää sisään toisen Component-ohjelman omine kenttineen, datasourceineen ja tapahtumineen, toisin kuin isolla alkukirjaimella kirjoitettu design-system-tagi. Välitä arvot sen _in-parametreihin xu-exp:<param>-attribuuteilla. Toisin kuin design-system-tagi, panel voi kirjoittaa arvoja takaisin sinun kenttiisi _out-parametriensa kautta.
Esimerkki
Valitse muoto
Valitse single New Component -ikkunassa yhtä tietuetta varten: rakenna suoraan xu-template-juuren sisään. Valitse multi luetteloa varten: se luo juuren sisään xu-multi-viewin puolestasi, ja toistuvaan solmuun lisäät xu-forin (tai .xu-tiedoston for=-oikotien).
Sido data
xu-bind syötteille, xu-exp:xu-content lasketulle tekstille ja progDataSource, jos componentti omistaa oman lukunsa.
Kytke vuorovaikutus
xu-on:click ja työnkulku, tai .xu-tiedostossa nimetty toimintolohko, johon viitataan @clickillä.
Rakenna puu kankaalla: vedä elementtejä, aseta attribuutit ominaisuuspaneelissa ja kytke xu-on:*-käsittelijät työnkulun vaiheisiin työnkuluneditorissa. Tarkista tulos livenä painamalla esikatselun play-painiketta.
.xu kääntää <single-view>in muotoon xu-single-view, :contentin xu-exp:xu-content-lausekkeeksi ja paljaan for="@list_v"-attribuutin muotoon xu-for.