Globaler
Det enda program som alla andra program kan läsa från, för tillstånd och logik som hör till hela appen i stället för en enskild skärm.
Varje Xuda-projekt har exakt ett Globaler-program. Det innehåller konstanter, delade variabler och startlogik som alla komponent-, Hämta data-, Sätt data-, Batch-, JavaScript- eller API-program i projektet kan läsa, så att ett värde som betyder samma sak överallt (den inloggade användaren, en funktionsflagga, den aktiva campusen) har exakt ett hem i stället för att kopieras in i varje skärm som behöver det.
Vad runAt än säger på andra ställen tvingar körmiljön Globaler till client. Det är den enda programtypen som aldrig körs på servern, så den är fel plats för allt som måste hållas borta från enheten (hemligheter, privilegierade läsningar). Använd ett Hämta data- eller Sätt data-program på serversidan för det.
När du ska använda det
Använd Globaler när ett värde eller en bit startlogik behövs av mer än en komponent och du inte vill skicka runt det som parameter till var och en av dem: den inloggade användarens namn, en vald campus eller hyresgäst, en flagga för mörkt läge, en supportadress, ett raise_event-nav som flera orelaterade skärmar kan lyssna på.
Använd det inte för något som hör till en enda skärm (det är ett komponentfält) eller något som måste köras på serversidan.
Egenskaper
Dokumentet ligger på studio_meta.parentId: "globals", roten till sin egen gren i trädet, skild från programs, database och routes. Ett projekts Globaler-dokument och trädroten kan inte tas bort.
progFields
Varje post deklarerar en variabel, läsbar överallt som @field_id.
Systemglobaler finns alltid tillgängliga vid sidan av dina egna: @SYS_GLOBAL_OBJ_LOGIN_USER_INFO (objektet för den inloggade användaren) och @SYS_GLOBAL_OBJ_REFS (element registrerade med xu-ref, som används för laddnings- och tomlägen).
progEvents
Globaler stöder samma progEvents-form som alla andra program, men inte varje händelsetyp i plattformen gäller för det. Kontrollen begränsar screen_ready, on_refresh, on_unload och client_interval till enbart komponenter. Att deklarera någon av dem på ett Globaler-program är ett hårt valideringsfel. Det som Globaler faktiskt stöder:
En äldre beskrivning av den här enheten påstod att Globaler kunde pollas med ett intervall (client_interval) eller enligt ett servercron-schema (server_cron). Ingetdera håller mot den nuvarande kontrollen: client_interval valideras som enbart för komponenter, och server_cron är inte en känd händelsetyp alls, dess enda spår i körmiljön är en bortkommenterad hanterare. Om ett projekt behöver återkommande polling i dag, lägg timern på en komponent (client_interval där är verklig och levande) i stället för på Globaler.
Genomgånget exempel
Deklarera det delade tillståndet
Lägg till fält för de värden som varje skärm behöver: selected_campus_v, signed_in_user_v, dark_mode_v.
Läs dem var som helst
Varje komponent, program eller uttryck i projektet läser dem på samma sätt, med @: @selected_campus_v.
Utlös en övergripande händelse
Ge Globaler en user_defined-händelse (till exempel campus_changed) och anropa den med raise_event från den komponent som ändrar campus. Varje annan öppen komponent som också satt upp en raise_event-lyssnare för det namnet reagerar, utan någon direkt referens mellan de två skärmarna.
I Studio-trädet är Globaler den enda noden i roten på sin egen gren (inte nästlad under Program). Öppna den, lägg till rader i tabellen Fält för varje delad variabel med en typ och ett standardvärde, och lägg till rader i Händelser för on_load / on_exit / valfri namngiven händelse, var och en med sitt eget arbetsflöde.