Variabili globali
L'unico programma che ogni altro programma può leggere, per stato e logica che appartengono all'intera app invece che a una sola schermata.
Ogni progetto Xuda ha esattamente un programma Variabili globali. Contiene le costanti, le variabili condivise e la logica di avvio che qualsiasi programma Componente, Leggi dati, Imposta dati, Batch, JavaScript o API del progetto può leggere, così un valore che significa la stessa cosa ovunque (l'utente connesso, un feature flag, il campus attivo) ha un'unica casa invece di essere copiato in ogni schermata che ne ha bisogno.
Qualunque cosa dica runAt altrove, il runtime forza le Variabili globali su client. È l'unico tipo di programma che non viene mai eseguito sul server, quindi è il posto sbagliato per qualsiasi cosa debba restare fuori dal dispositivo (segreti, letture privilegiate). Per quello usa un programma Leggi dati o Imposta dati lato server.
Quando usarle
Ricorri alle Variabili globali quando un valore o un pezzo di logica di avvio serve a più di un Componente e non vuoi passarlo come parametro a ciascuno di essi: il nome dell'utente connesso, un campus o tenant selezionato, un flag di modalità scura, un indirizzo email di supporto, un hub raise_event che più schermate non collegate possono ascoltare.
Non usarle per nulla che appartenga a una sola schermata (quello è un campo del Componente) né per nulla che debba essere eseguito lato server.
Proprietà
Il documento si trova in studio_meta.parentId: "globals", la radice di un proprio ramo nell'albero, separato da programs, database e routes. Il documento Variabili globali di un progetto e la radice dell'albero non possono essere eliminati.
progFields
Ogni voce dichiara una variabile, leggibile ovunque come @field_id.
Le variabili globali di sistema sono sempre disponibili accanto alle tue: @SYS_GLOBAL_OBJ_LOGIN_USER_INFO (l'oggetto dell'utente connesso) e @SYS_GLOBAL_OBJ_REFS (gli elementi registrati con xu-ref, usati per gli stati di caricamento e di vuoto).
progEvents
Le Variabili globali supportano la stessa forma progEvents di ogni altro programma, ma non tutti i tipi di evento della piattaforma si applicano ad esse. Il controllo limita screen_ready, on_refresh, on_unload e client_interval ai soli Componenti; dichiararne uno su un programma Variabili globali è un errore di validazione bloccante. Ciò che le Variabili globali supportano davvero:
Una descrizione più vecchia di questa unità sosteneva che le Variabili globali potessero fare polling a intervalli (client_interval) o con una pianificazione cron del server (server_cron). Nessuna delle due regge al confronto con il controllo attuale: client_interval è validato come solo per componenti e server_cron non è affatto un tipo di evento riconosciuto, la sua unica traccia nel runtime è un gestore commentato. Se oggi un progetto ha bisogno di un polling ricorrente, metti il timer su un Componente (lì client_interval è reale e attivo) invece che sulle Variabili globali.
Esempio pratico
Dichiara lo stato condiviso
Aggiungi i campi per i valori di cui ogni schermata ha bisogno: selected_campus_v, signed_in_user_v, dark_mode_v.
Leggili da qualsiasi punto
Qualsiasi Componente, programma o espressione del progetto li legge nello stesso modo, con @: @selected_campus_v.
Solleva un evento trasversale
Dai alle Variabili globali un evento user_defined (per esempio campus_changed) e chiamalo con raise_event da qualunque Componente cambi il campus. Ogni altro Componente aperto che abbia a sua volta registrato un listener raise_event per quel nome reagisce, senza un riferimento diretto tra le due schermate.
Nell'albero di Studio, le Variabili globali sono l'unico nodo alla radice di un proprio ramo (non annidato sotto Programmi). Aprilo, aggiungi righe alla tabella Campi per ogni variabile condivisa con un tipo e un valore predefinito, e aggiungi righe a Eventi per on_load / on_exit / qualsiasi evento con nome, ciascuna con un proprio workflow.