Globaalit
Ohjelma, jota jokainen muu ohjelma voi lukea, tilalle ja logiikalle, joka kuuluu koko sovellukselle yhden näkymän sijaan.
Jokaisella Xuda-projektilla on täsmälleen yksi Globaalit-ohjelma. Se sisältää vakiot, jaetut muuttujat ja käynnistyslogiikan, jota mikä tahansa projektin Komponentti-, Hae dataa-, Aseta dataa-, Batch-, JavaScript- tai API-ohjelma voi lukea. Näin arvolla, joka tarkoittaa kaikkialla samaa (kirjautunut käyttäjä, ominaisuuslippu, aktiivinen kampus), on täsmälleen yksi koti sen sijaan, että se kopioitaisiin jokaiseen sitä tarvitsevaan näkymään.
Mitä runAt muualla sanookaan, ajoympäristö pakottaa Globaalit-ohjelman arvoon client. Se on ainoa ohjelmatyyppi, joka ei koskaan suorita palvelimella, joten se on väärä paikka kaikelle, minkä täytyy pysyä poissa laitteelta (salaisuudet, etuoikeutetut luvut). Käytä siihen palvelinpuolen Hae dataa- tai Aseta dataa -ohjelmaa.
Milloin sitä käytetään
Käytä Globaaleja, kun arvoa tai käynnistyslogiikan palasta tarvitaan useammassa kuin yhdessä Komponentissa etkä halua välittää sitä parametrina jokaiselle niistä: kirjautuneen käyttäjän nimi, valittu kampus tai vuokralainen, tumman tilan lippu, tukisähköpostiosoite, raise_event-keskitin, jota useat toisistaan riippumattomat näkymät voivat kuunnella.
Älä käytä sitä millekään, mikä kuuluu yhdelle näkymälle (se on Komponentin kenttä), tai millekään, minkä täytyy ajaa palvelimella.
Ominaisuudet
Dokumentti sijaitsee kohdassa studio_meta.parentId: "globals", oman haaransa juuressa puussa, erillään kohdista programs, database ja routes. Projektin Globaalit-dokumenttia ja puun juurta ei voi poistaa.
progFields
Jokainen merkintä ilmoittaa yhden muuttujan, joka on luettavissa kaikkialla muodossa @field_id.
Järjestelmän globaalit ovat aina käytettävissä omiesi rinnalla: @SYS_GLOBAL_OBJ_LOGIN_USER_INFO (kirjautuneen käyttäjän objekti) ja @SYS_GLOBAL_OBJ_REFS (elementit, jotka on rekisteröity xu-ref:llä, käytetään lataus- ja tyhjätiloihin).
progEvents
Globaalit tukee samaa progEvents-muotoa kuin jokainen muu ohjelma, mutta kaikki alustan tapahtumatyypit eivät koske sitä. Tarkistin rajaa screen_ready, on_refresh, on_unload ja client_interval vain Komponenteille. Minkä tahansa niistä ilmoittaminen Globaalit-ohjelmassa on kova validointivirhe. Mitä Globaalit todella tukee:
Tämän yksikön vanhempi kuvaus väitti, että Globaalit voisi kyselyttää aikavälein (client_interval) tai palvelimen cron-aikataululla (server_cron). Kumpikaan ei pidä paikkaansa nykyistä tarkistinta vasten: client_interval validoidaan vain komponenteille, eikä server_cron ole tunnistettu tapahtumatyyppi lainkaan, sen ainoa jälki ajoympäristössä on kommentoitu käsittelijä. Jos projekti tarvitsee toistuvaa kyselyä nyt, aseta ajastin Komponenttiin (client_interval on siellä todellinen ja toimiva) Globaalien sijaan.
Käyttöesimerkki
Ilmoita jaettu tila
Lisää kentät arvoille, joita jokainen näkymä tarvitsee: selected_campus_v, signed_in_user_v, dark_mode_v.
Lue ne mistä tahansa
Mikä tahansa projektin Komponentti, ohjelma tai lauseke lukee ne samalla tavalla @-merkillä: @selected_campus_v.
Nosta läpileikkaava tapahtuma
Anna Globaaleille user_defined-tapahtuma (esimerkiksi campus_changed) ja kutsu sitä komennolla raise_event siitä Komponentista, joka vaihtaa kampuksen. Jokainen muu avoin Komponentti, joka on myös asettanut raise_event-kuuntelijan sille nimelle, reagoi ilman suoraa viittausta näiden kahden näkymän välillä.
Studion puussa Globaalit on yksittäinen solmu oman haaransa juuressa (ei Ohjelmien alla). Avaa se, lisää Kentät-taulukkoon rivit jokaiselle jaetulle muuttujalle tyyppeineen ja oletusarvoineen ja lisää Tapahtumat-kohtaan rivit tapahtumille on_load / on_exit / mikä tahansa nimetty tapahtuma, kullakin oma työnkulkunsa.