Přeskočit na obsah
Ověřeno

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.

Globální proměnné vždy běží na klientovi

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í:

Žádný client_interval ani server_cron u Globálních proměnných

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.

xml
<meta lang="json5">
{
  id: "school_globals",
  menuTitle: "School Globals"
}
</meta>

<fields lang="json5">
{
  selected_campus_v: { type: "string", value: "Boston Campus" },
  signed_in_user_v: { type: "string", value: "Avery Walker" },
  support_email_v: { type: "string", value: "[email protected]" },
  dark_mode_v: { type: "boolean", value: false }
}
</fields>
json
{
  "properties": {
    "menuType": "globals",
    "menuName": "School Globals",
    "progDescription": "Campus and operator state shared across the app."
  },
  "progFields": [
    {
      "id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
      "data": { "field_id": "selected_campus_v", "type": "virtual" },
      "props": { "fieldType": "string", "fieldValue": "Boston Campus" }
    }
  ],
  "progEvents": [
    { "id": "d4e5f6a7-b8c9-4d0e-af1a-3b4c5d6e7f8a", "data": { "type": "on_load", "parameters": [], "condition": "" }, "workflow": [] }
  ],
  "progDataSource": {}
}