Globale variabler
Det ene programmet alle andre programmer kan lese fra, for tilstand og logikk som hører til hele appen i stedet for én skjerm.
Hvert Xuda-prosjekt har nøyaktig ett Globale variabler-program. Det rommer konstantene, de delte variablene og oppstartslogikken som alle Component-, Get Data-, Set Data-, Batch-, JavaScript- eller API-programmer i prosjektet kan lese, slik at en verdi som betyr det samme overalt (brukeren som er pålogget, et funksjonsflagg, den aktive campusen) har ett eneste hjem i stedet for å bli kopiert inn i hver skjerm som trenger den.
Uansett hva runAt sier andre steder, tvinger kjøretiden Globale variabler til client. Det er den ene programtypen som aldri kjører på serveren, så det er feil sted for alt som må holdes unna enheten (hemmeligheter, privilegerte lesinger). Bruk et Get Data- eller Set Data-program på serversiden til det.
Når du bruker det
Bruk Globale variabler når en verdi eller en bit oppstartslogikk trengs av mer enn én Component og du ikke vil sende den rundt som parameter til hver av dem: navnet til brukeren som er pålogget, en valgt campus eller leietaker, et flagg for mørk modus, en support-e-postadresse, en raise_event-sentral som flere urelaterte skjermer kan lytte til.
Ikke bruk det til noe som hører til én enkelt skjerm (det er et felt i en Component) eller noe som må kjøre på serversiden.
Egenskaper
Dokumentet ligger på studio_meta.parentId: "globals", roten til sin egen gren i treet, adskilt fra programs, database og routes. Et prosjekts Globale variabler-dokument og trerota kan ikke slettes.
progFields
Hver oppføring deklarerer én variabel, som kan leses overalt som @field_id.
Systemets globale variabler er alltid tilgjengelige ved siden av dine egne: @SYS_GLOBAL_OBJ_LOGIN_USER_INFO (objektet for brukeren som er pålogget) og @SYS_GLOBAL_OBJ_REFS (elementer registrert med xu-ref, brukt for lasting og tomme tilstander).
progEvents
Globale variabler støtter den samme progEvents-formen som alle andre programmer, men ikke hver hendelsestype på plattformen gjelder for det. Kontrollen begrenser screen_ready, on_refresh, on_unload og client_interval til Components alene. Å deklarere en av dem på et Globale variabler-program er en hard valideringsfeil. Dette støtter Globale variabler faktisk:
En eldre beskrivelse av denne enheten hevdet at Globale variabler kunne polle med et intervall (client_interval) eller etter en cron-plan på serveren (server_cron). Ingen av delene holder mot den nåværende kontrollen: client_interval valideres som kun for Component, og server_cron er ikke en gjenkjent hendelsestype i det hele tatt, det eneste sporet i kjøretiden er en kommentert ut håndterer. Hvis et prosjekt i dag trenger gjentatt polling, legg timeren på en Component (client_interval der er ekte og i live) i stedet for på Globale variabler.
Eksempel
Deklarer den delte tilstanden
Legg til felt for verdiene hver skjerm trenger: selected_campus_v, signed_in_user_v, dark_mode_v.
Les dem fra hvor som helst
Hver Component, hvert program eller hvert uttrykk i prosjektet leser dem på samme måte, med @: @selected_campus_v.
Utløs en hendelse på tvers
Gi Globale variabler en user_defined-hendelse (for eksempel campus_changed) og kall den med raise_event fra den Component som endrer campusen. Hver annen åpen Component som også har satt opp en raise_event-lytter for det navnet reagerer, uten en direkte referanse mellom de to skjermene.
I Studio-treet er Globale variabler den ene noden i roten av sin egen gren (ikke nestet under Programmer). Åpne den, legg til rader i Felt-tabellen for hver delte variabel med en type og en standardverdi, og legg til rader i Hendelser for on_load / on_exit / en hvilken som helst navngitt hendelse, hver med sin egen arbeidsflyt.