Hopp til innholdet
Bekreftet

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.

Globale variabler kjører alltid på klienten

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:

Ingen client_interval eller server_cron på Globale variabler

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.

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