Globale variabelen
Het ene programma dat elk ander programma kan lezen, voor status en logica die bij de hele app horen in plaats van bij één scherm.
Elk Xuda-project heeft precies één programma Globale variabelen. Het bevat de constanten, gedeelde variabelen en opstartlogica die elk Component-, Gegevens-ophalen-, Gegevens-instellen-, Batch-, JavaScript- of API-programma in het project kan lezen, zodat een waarde die overal hetzelfde betekent (de ingelogde gebruiker, een feature flag, de actieve campus) precies één thuis heeft in plaats van te worden gekopieerd naar elk scherm dat hem nodig heeft.
Wat runAt elders ook zegt, de runtime dwingt Globale variabelen af op client. Het is het enige programmatype dat nooit op de server draait, dus het is de verkeerde plek voor alles wat buiten het apparaat moet blijven (geheimen, bevoorrechte leesacties). Gebruik daarvoor een Gegevens-ophalen- of Gegevens-instellen-programma op de server.
Wanneer gebruik je het
Gebruik Globale variabelen als een waarde of een stuk opstartlogica door meer dan één Component nodig is en je hem niet bij elk ervan als parameter wilt doorgeven: de naam van de ingelogde gebruiker, een gekozen campus of tenant, een donkere-modusvlag, een e-mailadres voor support, een raise_event-hub waar meerdere niet-verwante schermen naar kunnen luisteren.
Gebruik het niet voor iets dat bij één scherm hoort (dat is een veld van een Component) of iets dat aan de serverkant moet draaien.
Eigenschappen
Het document staat op studio_meta.parentId: "globals", de wortel van zijn eigen tak in de boom, los van programs, database en routes. Het Globale-variabelendocument van een project en de wortel van de boom kunnen niet worden verwijderd.
progFields
Elke vermelding declareert één variabele, overal leesbaar als @field_id.
Systeemglobals zijn altijd beschikbaar naast je eigen: @SYS_GLOBAL_OBJ_LOGIN_USER_INFO (het object van de ingelogde gebruiker) en @SYS_GLOBAL_OBJ_REFS (elementen die met xu-ref zijn geregistreerd, gebruikt voor laad- en lege toestanden).
progEvents
Globale variabelen ondersteunen dezelfde progEvents-vorm als elk ander programma, maar niet elk gebeurtenistype van het platform is erop van toepassing. De checker beperkt screen_ready, on_refresh, on_unload en client_interval tot alleen Components; een van die gebeurtenissen declareren op een programma Globale variabelen is een harde validatiefout. Wat Globale variabelen echt ondersteunen:
Een oudere beschrijving van deze eenheid beweerde dat Globale variabelen konden pollen met een interval (client_interval) of met een servercronschema (server_cron). Geen van beide houdt stand tegenover de huidige checker: client_interval wordt gevalideerd als alleen voor Components, en server_cron is helemaal geen herkend gebeurtenistype, het enige spoor in de runtime is een uitgecommentarieerde handler. Als een project vandaag terugkerend pollen nodig heeft, zet de timer dan op een Component (client_interval is daar echt en werkt) in plaats van op Globale variabelen.
Uitgewerkt voorbeeld
Declareer de gedeelde status
Voeg velden toe voor de waarden die elk scherm nodig heeft: selected_campus_v, signed_in_user_v, dark_mode_v.
Lees ze van overal
Elke Component, elk programma of elke expressie in het project leest ze op dezelfde manier, met @: @selected_campus_v.
Roep een gebeurtenis op die meerdere schermen raakt
Geef Globale variabelen een user_defined-gebeurtenis (bijvoorbeeld campus_changed) en roep hem op met raise_event vanuit de Component die de campus wijzigt. Elke andere open Component die ook een raise_event-luisteraar voor die naam heeft, reageert, zonder directe verwijzing tussen de twee schermen.
In de Studio-boom is Globale variabelen het enige knooppunt aan de wortel van zijn eigen tak (niet onder Programma's genest). Open het, voeg rijen toe aan de tabel Velden voor elke gedeelde variabele met een type en standaardwaarde, en voeg rijen toe aan Gebeurtenissen voor on_load / on_exit / elke benoemde gebeurtenis, elk met een eigen workflow.