Preskočiť na obsah
Overené

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.

Globálne premenné vždy bežia na klientovi

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

V Globálnych premenných nie je client_interval ani server_cron

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.

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": {}
}