Globaler
Det ene program, som alle andre programmer kan læse fra, til tilstand og logik, der hører til hele appen i stedet for én skærm.
Hvert Xuda-projekt har præcis ét Globaler-program. Det rummer de konstanter, delte variabler og opstartslogik, som alle Komponent-, Hent data-, Sæt data-, Batch-, JavaScript- eller API-programmer i projektet kan læse. En værdi, der betyder det samme overalt (den loggede bruger, et feature-flag, den aktive campus), har dermed præcis ét hjem i stedet for at blive kopieret ind på hver skærm, der har brug for den.
Uanset hvad runAt siger andre steder, tvinger runtime Globaler til client. Det er den ene programtype, der aldrig kører på serveren, så det er det forkerte sted til alt, der skal holdes væk fra enheden (hemmeligheder, privilegerede læsninger). Brug et Hent data- eller Sæt data-program på serversiden til det.
Hvornår du bruger det
Brug Globaler, når en værdi eller et stykke opstartslogik er nødvendigt for mere end én Komponent, og du ikke vil sende den rundt som parameter til hver af dem: den loggede brugers navn, en valgt campus eller lejer, et mørk tilstand-flag, en support-e-mailadresse, en raise_event-hub, som flere urelaterede skærme kan lytte til.
Brug det ikke til noget, der hører til en enkelt skærm (det er et Komponent-felt), eller noget, der skal køre på serversiden.
Egenskaber
Dokumentet ligger under studio_meta.parentId: "globals", roden til sin egen gren i træet, adskilt fra programs, database og routes. Et projekts Globaler-dokument og træets rod kan ikke slettes.
progFields
Hver post erklærer én variabel, der kan læses overalt som @field_id.
Systemglobaler er altid tilgængelige ved siden af dine egne: @SYS_GLOBAL_OBJ_LOGIN_USER_INFO (objektet for den loggede bruger) og @SYS_GLOBAL_OBJ_REFS (elementer registreret med xu-ref, brugt til indlæsnings- og tomme tilstande).
progEvents
Globaler understøtter den samme progEvents-form som alle andre programmer, men ikke alle hændelsestyper på platformen gælder for det. Kontrollen begrænser screen_ready, on_refresh, on_unload og client_interval til kun Komponenter. Hvis du erklærer en af dem på et Globaler-program, giver det en hård valideringsfejl. Det, Globaler faktisk understøtter:
En ældre beskrivelse af denne enhed påstod, at Globaler kunne polle på et interval (client_interval) eller efter en server-cron-plan (server_cron). Ingen af delene holder mod den nuværende kontrol: client_interval valideres som kun for Komponenter, og server_cron er slet ikke en genkendt hændelsestype, dens eneste spor i runtime er en udkommenteret håndtering. Hvis et projekt i dag har brug for tilbagevendende polling, så læg timeren på en Komponent (client_interval er rigtig og levende der) i stedet for på Globaler.
Eksempel
Erklær den delte tilstand
Tilføj felter til de værdier, som hver skærm har brug for: selected_campus_v, signed_in_user_v, dark_mode_v.
Læs dem hvor som helst fra
Enhver Komponent, ethvert program og ethvert udtryk i projektet læser dem på samme måde, med @: @selected_campus_v.
Rejs en tværgående hændelse
Giv Globaler en user_defined-hændelse (for eksempel campus_changed) og kald den med raise_event fra den Komponent, der ændrer campus. Hver anden åben Komponent, der også har en raise_event-lytter på det navn, reagerer, uden en direkte reference mellem de to skærme.
I Studio-træet er Globaler den eneste node i roden af sin egen gren (ikke indlejret under Programmer). Åbn den, tilføj rækker til tabellen Felter for hver delt variabel med en type og en standardværdi, og tilføj rækker til Hændelser for on_load / on_exit / enhver navngiven hændelse, hver med sin egen workflow.