Globális változók
Az az egy program, amelyből minden más program olvashat, az egész alkalmazáshoz tartozó állapotnak és logikának, nem egyetlen képernyőének.
Minden Xuda-projektnek pontosan egy Globális változók programja van. Ez tartalmazza azokat az állandókat, megosztott változókat és indítási logikát, amelyeket a projekt bármely Component, Get Data, Set Data, Batch, JavaScript vagy API programja olvashat, így az az érték, amely mindenhol ugyanazt jelenti (a bejelentkezett felhasználó, egy funkciójelző, az aktív campus), pontosan egy otthont kap, ahelyett, hogy minden képernyőre, amelyen szükség van rá, átmásolnák.
Bármit mond is máshol a runAt, a futtatókörnyezet a Globális változókat client értékre kényszeríti. Ez az egyetlen programtípus, amely soha nem fut a szerveren, ezért rossz hely mindennek, aminek az eszközön kívül kell maradnia (titkok, kiváltságos olvasások). Ahhoz használjon szerveroldali Get Data vagy Set Data programot.
Mikor használja
A Globális változókhoz akkor nyúljon, ha egy értékre vagy indítási logikára egynél több Componentnek van szüksége, és nem szeretné paraméterként továbbadni mindegyiknek: a bejelentkezett felhasználó neve, a kiválasztott campus vagy bérlő, egy sötét mód jelző, egy támogatási e-mail-cím, egy raise_event csomópont, amelyre több egymástól független képernyő is figyelhet.
Ne használja olyasmire, ami egyetlen képernyőhöz tartozik (az egy Component-mező), vagy aminek a szerveren kell futnia.
Tulajdonságok
A dokumentum a studio_meta.parentId: "globals" helyen áll, a fa saját ágának gyökerében, a programs, database és routes ágaktól elkülönülve. A projekt Globális változók dokumentuma és a fa gyökere nem törölhető.
progFields
Minden bejegyzés egy változót deklarál, amely mindenhol @field_id néven olvasható.
A rendszer globális változói mindig elérhetők a sajátjai mellett: @SYS_GLOBAL_OBJ_LOGIN_USER_INFO (a bejelentkezett felhasználó objektuma) és @SYS_GLOBAL_OBJ_REFS (a xu-ref jelöléssel regisztrált elemek, betöltési és üres állapotokhoz).
progEvents
A Globális változók ugyanazt a progEvents alakot támogatja, mint minden más program, de a platform nem minden eseménytípusa vonatkozik rá. Az ellenőrző a screen_ready, on_refresh, on_unload és client_interval eseményeket csak a Componentekre korlátozza; ezek bármelyikének deklarálása egy Globális változók programon súlyos érvényesítési hiba. Amit a Globális változók ténylegesen támogat:
Ennek az egységnek egy régebbi leírása azt állította, hogy a Globális változók időközönként (client_interval) vagy szerveroldali cron-ütemezéssel (server_cron) tud lekérdezni. Egyik sem áll meg a jelenlegi ellenőrzővel szemben: a client_interval csak komponensekre érvényesül, a server_cron pedig egyáltalán nem felismert eseménytípus, a futtatókörnyezetben egyetlen nyoma egy kikommentezett kezelő. Ha a projektnek ma ismétlődő lekérdezésre van szüksége, az időzítőt Componentre tegye (ott a client_interval valódi és él), ne a Globális változókra.
Kidolgozott példa
Deklarálja a megosztott állapotot
Adjon hozzá mezőket az értékekhez, amelyekre minden képernyőnek szüksége van: selected_campus_v, signed_in_user_v, dark_mode_v.
Olvassa őket bárhonnan
A projekt bármely Componentje, programja vagy kifejezése ugyanúgy olvassa őket, @ jellel: @selected_campus_v.
Váltson ki egy átfogó eseményt
Adjon a Globális változóknak egy user_defined eseményt (például campus_changed), és hívja meg a raise_event segítségével abból a Componentből, amelyik a campust változtatja. Minden más megnyitott Component, amelyik szintén raise_event figyelőt vett fel arra a névre, reagál, a két képernyő közötti közvetlen hivatkozás nélkül.
A Studio fájában a Globális változók az egyetlen csomópont a saját ágának gyökerében (nem a Programok alatt). Nyissa meg, adjon sorokat a Mezők táblához minden megosztott változóhoz típussal és alapértelmezett értékkel, és adjon sorokat az Események közé az on_load / on_exit / bármely elnevezett eseményhez, mindegyikhez saját munkafolyamattal.