Globálne premenné
Jediný program, z ktorého môže čítať každý iný program, pre stav a logiku, ktoré patria celej aplikácii, nie jednej obrazovke.
Každý projekt Xuda má presne jeden program Globálne premenné. Obsahuje konštanty, zdieľané premenné a štartovaciu logiku, ktoré môže čítať ktorýkoľvek program typu Komponent, Získať dáta, Nastaviť dáta, Batch, JavaScript alebo API v projekte, takže hodnota, ktorá znamená všade to isté (prihlásený používateľ, príznak funkcie, aktívny kampus), má presne jedno miesto namiesto kopírovania do každej obrazovky, ktorá ju potrebuje.
Nech runAt inde hovorí čokoľvek, runtime vynúti pre Globálne premenné hodnotu client. Je to jediný typ programu, ktorý sa nikdy nevykonáva na serveri, takže je nesprávnym miestom pre čokoľvek, čo musí zostať mimo zariadenia (tajomstvá, privilegované čítania). Na to použite serverový program Získať dáta alebo Nastaviť dáta.
Kedy ich použiť
Siahnite po Globálnych premenných, keď je hodnota alebo kus štartovacej logiky potrebný viac ako jednému Komponentu a nechcete ju posúvať ako parameter do každého z nich: meno prihláseného používateľa, vybraný kampus alebo nájomca, príznak tmavého režimu, e-mailová adresa podpory, centrum raise_event, ktoré môže počúvať niekoľko nesúvisiacich obrazoviek.
Nepoužívajte ich na nič, čo patrí jednej obrazovke (to je pole Komponentu), ani na nič, čo musí bežať na serveri.
Vlastnosti
Dokument sa nachádza v studio_meta.parentId: "globals", v koreni vlastnej vetvy stromu, oddelenej od programs, database a routes. Dokument Globálnych premenných projektu a koreň stromu nemožno odstrániť.
progFields
Každý záznam deklaruje jednu premennú, čitateľnú všade ako @field_id.
Systémové globálne premenné sú vždy k dispozícii popri vašich vlastných: @SYS_GLOBAL_OBJ_LOGIN_USER_INFO (objekt prihláseného používateľa) a @SYS_GLOBAL_OBJ_REFS (prvky zaregistrované cez xu-ref, používané pre stavy načítavania a prázdne stavy).
progEvents
Globálne premenné podporujú rovnaký tvar progEvents ako každý iný program, ale nie každý typ udalosti na platforme sa na ne vzťahuje. Kontrola obmedzuje screen_ready, on_refresh, on_unload a client_interval len na Komponenty; deklarovanie niektorej z nich v programe Globálnych premenných je tvrdá chyba overenia. Čo Globálne premenné skutočne podporujú:
Staršie znenie tejto jednotky tvrdilo, že Globálne premenné môžu dopytovať v intervale (client_interval) alebo podľa serverového plánu cron (server_cron). Ani jedno neobstojí proti súčasnej kontrole: client_interval je overovaný ako len pre komponenty a server_cron nie je rozpoznaný typ udalosti vôbec, jeho jediná stopa v runtime je zakomentovaná obsluha. Ak projekt dnes potrebuje opakované dopytovanie, dajte časovač na Komponent (client_interval tam je skutočný a živý), nie na Globálne premenné.
Ukážkový príklad
Deklarujte zdieľaný stav
Pridajte polia pre hodnoty, ktoré potrebuje každá obrazovka: selected_campus_v, signed_in_user_v, dark_mode_v.
Čítajte ich odkiaľkoľvek
Ktorýkoľvek Komponent, program alebo výraz v projekte ich číta rovnako, cez @: @selected_campus_v.
Vyvolajte prierezovú udalosť
Dajte Globálnym premenným udalosť user_defined (napríklad campus_changed) a zavolajte ju cez raise_event z ktoréhokoľvek Komponentu, ktorý kampus mení. Každý ďalší otvorený Komponent, ktorý tiež vyvolal poslucháča raise_event pre toto meno, zareaguje, bez priameho odkazu medzi týmito dvoma obrazovkami.
V strome Studia sú Globálne premenné jediným uzlom v koreni vlastnej vetvy (nie vnoreným pod Programami). Otvorte ho, pridajte riadky do tabuľky Polia pre každú zdieľanú premennú s typom a predvolenou hodnotou a pridajte riadky do Udalostí pre on_load / on_exit / ľubovoľnú pomenovanú udalosť, každú s vlastným pracovným postupom.