Vai al contenuto
Verificata

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_data generati
  • 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.

html
<script src="https://xuda.ai/dist/runtime/js/xuda-runtime-slim.js"></script>
Non caricare da un host di sviluppo in produzione

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

js
new xuda(element?, options?, callback?)
new xuda.xuda(element?, options?, callback?)

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 su document.body e registra un avviso invece di fallire.
  • options: opzioni di sessione e di runtime, descritte più avanti.
  • callback: chiamata come callback('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:

js
document.body.addEventListener('on_mounted', () => {
  console.log('Slim page mounted');
}, { once: true });

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_id mostra qualcosa di visibile
  • l'evento on_mounted viene 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).