Xuda Slim
Il punto di ingresso leggero del browser nel runtime Xuda, senza bisogno di un loader di progetto.
Xuda Slim è la superficie leggera di scrittura e incorporamento per il runtime Xuda. È utile quando vuoi il datasource reattivo, le direttive, gli eventi e i tag strutturali di Xuda, senza partire dalla struttura completa di un progetto Xuda CLI.
Slim è comunque Xuda, non un runtime diverso. Le espressioni leggono ancora i campi con @field_name, il runtime lavora ancora a partire dai documenti di programma Xuda, e i tag strutturali come xu-single-view e xu-panel contano ancora. <template> è supportato, ma non è obbligatorio.
A che cosa serve Slim
- pagine HTML scritte a mano con la reattività di Xuda
- demo del runtime e documentazione
- widget incorporabili o micrositi
- alberi di runtime
project_datagenerati - adozione progressiva di Xuda senza introdurre subito un compilatore di sorgenti completo
I tre modi di scrittura
Questi modi possono essere combinati: se Slim riceve project_data e la pagina ha anche dei tag <template>, i template vengono analizzati e aggiunti a project_data.programs insieme a esso.
Caricare il runtime
Il modo supportato per ottenere il bundle è il pacchetto npm pubblico @xuda.io/xuda-runtime-slim-es. Se hai un'app Xuda distribuita, la piattaforma serve il bundle del runtime anche dal dominio della tua app a /cdn, con una build non minificata a /cdn/debug.
Il tag script qui sopra punta a un host di sviluppo, utile per provare Slim in locale. Una pagina distribuita dovrebbe caricare @xuda.io/xuda-runtime-slim-es, oppure servire il bundle dal dominio della tua app a /cdn.
Il costruttore
Gli argomenti vengono riconosciuti per tipo, non per posizione: un elemento, un oggetto di opzioni e una callback possono essere passati in qualsiasi ordine.
element: l'elemento DOM in cui montare. Facoltativo in Slim: omettilo e il runtime ripiega sudocument.bodye registra un avviso invece di fallire.options: opzioni di sessione e di runtime, descritte più avanti.callback: chiamata comecallback('xuda_ready', SESSION_ID, SESSION_OBJ)quando l'app è pronta.
Per il completamento del montaggio, l'aggancio più affidabile è l'evento on_mounted su document.body:
Opzioni comuni
Ogni opzione qui sotto viene risolta attraverso la stessa catena di sei passaggi: prima un parametro della query URL, poi un attributo sull'elemento radice, poi options.params[key], poi options[key], poi un cookie, poi localStorage. Ecco perché una pagina Slim può essere riconfigurata da una query string senza modificare il codice.
Come capire che Slim funziona
- il bundle è stato caricato
- il tuo
prog_idmostra qualcosa di visibile - l'evento
on_mountedviene emesso - l'UI guidata dai campi inizia a comportarsi in modo reattivo
Se succedono tutte e quattro le cose, la pagina è a posto. Se non viene mostrato nulla, controlla in ordine: che il bundle sia stato davvero caricato, che prog_id corrisponda a un vero id di template o a una chiave di programma, che il programma esista in project_data.programs e che la destinazione di montaggio sia un vero elemento (o lasciata di proposito al ripiego su body).