Globální proměnné
Jediný program, ze kterého mohou číst všechny ostatní programy, pro stav a logiku, které patří celé aplikaci, ne jedné obrazovce.
Každý projekt Xuda má právě jeden program Globální proměnné. Obsahuje konstanty, sdílené proměnné a logiku spouštění, které může číst jakýkoli program Komponenta, Získat data, Nastavit data, Dávka, JavaScript nebo API v projektu, takže hodnota, která znamená všude totéž (přihlášený uživatel, příznak funkce, aktivní kampus), má právě jedno místo, místo aby se kopírovala do každé obrazovky, která ji potřebuje.
Ať runAt jinde říká cokoli, běh Globálních proměnných vynutí na client. Je to jediný typ programu, který se nikdy nespouští na serveru, takže je špatným místem pro cokoli, co musí zůstat mimo zařízení (tajné údaje, privilegovaná čtení). K tomu použijte serverový program Získat data nebo Nastavit data.
Kdy ho použít
Sáhněte po Globálních proměnných, když je hodnota nebo kus logiky spouštění potřeba ve více než jedné Komponentě a nechcete ji předávat jako parametr v každé z nich: jméno přihlášeného uživatele, vybraný kampus nebo tenant, příznak tmavého režimu, e-mailová adresa podpory, uzel raise_event, který může poslouchat několik nesouvisejících obrazovek.
Nepoužívejte je pro nic, co patří jedné obrazovce (to je pole Komponenty), ani pro nic, co musí běžet na serveru.
Vlastnosti
Dokument je umístěn na studio_meta.parentId: "globals", kořeni vlastní větve ve stromu, oddělené od programs, database a routes. Dokument Globálních proměnných projektu a kořen stromu nelze smazat.
progFields
Každý záznam deklaruje jednu proměnnou, čitelnou všude jako @field_id.
Systémové globální proměnné jsou vždy k dispozici vedle vašich vlastních: @SYS_GLOBAL_OBJ_LOGIN_USER_INFO (objekt přihlášeného uživatele) a @SYS_GLOBAL_OBJ_REFS (prvky zaregistrované pomocí xu-ref, používané pro stavy načítání a prázdné stavy).
progEvents
Globální proměnné podporují stejný tvar progEvents jako každý jiný program, ale ne každý typ události na platformě se na ně vztahuje. Kontrola omezuje screen_ready, on_refresh, on_unload a client_interval jen na Komponenty; deklarovat některou z nich u programu Globálních proměnných je tvrdá chyba ověření. Co Globální proměnné skutečně podporují:
Starší popis této jednotky tvrdil, že Globální proměnné mohou dotazovat v intervalu (client_interval) nebo podle plánu serverového cronu (server_cron). Ani jedno neobstojí proti současné kontrole: client_interval se ověřuje jako jen pro komponenty a server_cron není rozpoznaný typ události vůbec, jeho jedinou stopou v běhovém prostředí je zakomentovaná obsluha. Pokud projekt dnes potřebuje opakované dotazování, dejte časovač na Komponentu (client_interval je tam skutečný a živý), ne na Globální proměnné.
Pracovní příklad
Deklarujte sdílený stav
Přidejte pole pro hodnoty, které potřebuje každá obrazovka: selected_campus_v, signed_in_user_v, dark_mode_v.
Čtěte je odkudkoli
Každá Komponenta, program nebo výraz v projektu je čte stejně, pomocí @: @selected_campus_v.
Vyvolejte průřezovou událost
Dejte Globálním proměnným událost user_defined (například campus_changed) a volejte ji pomocí raise_event z kterékoli Komponenty, která kampus mění. Každá další otevřená Komponenta, která také vyvolala posluchače raise_event pro tento název, zareaguje, aniž by mezi oběma obrazovkami byl přímý odkaz.
Ve stromu Studia jsou Globální proměnné jediným uzlem v kořeni vlastní větve (ne vnořeným pod Programy). Otevřete ho, přidejte řádky do tabulky Pole pro každou sdílenou proměnnou s typem a výchozí hodnotou a přidejte řádky do Události pro on_load / on_exit / libovolnou pojmenovanou událost, každou s vlastním workflow.