Sari la conținut
Verificat

Xuda Slim

Punctul de intrare ușor, din browser, în runtime-ul Xuda, fără încărcător de proiect.

Xuda Slim este suprafața ușoară de creare și încorporare pentru runtime-ul Xuda. Este utilă când vrei datasource-ul reactiv, directivele, evenimentele și tag-urile structurale Xuda, fără să pornești de la forma completă a unui proiect Xuda CLI.

Slim este tot Xuda, nu un runtime diferit. Expresiile citesc în continuare câmpurile cu @field_name, runtime-ul lucrează în continuare cu documente de program Xuda, iar tag-urile structurale precum xu-single-view și xu-panel contează în continuare. <template> este acceptat, dar nu este obligatoriu.

La ce folosește Slim

  • pagini HTML scrise manual, cu reactivitate Xuda
  • demonstrații de runtime și documentație
  • widget-uri sau microsite-uri încorporabile
  • arbori de runtime project_data generați
  • adoptare treptată a Xuda, fără a introduce mai întâi un compilator complet de surse

Cele trei moduri de creare

Aceste moduri se pot combina: dacă Slim primește project_data și pagina are și tag-uri <template>, template-urile sunt parsate și adăugate în project_data.programs, alături de acesta.

Încărcarea runtime-ului

Modul acceptat de a obține bundle-ul este pachetul npm public @xuda.io/xuda-runtime-slim-es. Dacă ai o aplicație Xuda publicată, platforma servește bundle-ul de runtime și de pe propriul tău domeniu de aplicație, la /cdn, cu un build neminificat la /cdn/debug.

html
<script src="https://xuda.ai/dist/runtime/js/xuda-runtime-slim.js"></script>
Nu încărca de pe un host de dezvoltare în producție

Tag-ul script de mai sus indică un host de dezvoltare, util pentru a încerca Slim local. O pagină publicată trebuie să încarce @xuda.io/xuda-runtime-slim-es sau să servească bundle-ul de pe propriul tău domeniu de aplicație, la /cdn.

Constructorul

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

Argumentele sunt potrivite după tip, nu după poziție: un element, un obiect de opțiuni și un callback pot fi transmise în orice ordine.

  • element: elementul DOM în care se montează. Opțional în Slim: dacă îl omiți, runtime-ul revine la document.body și loghează un avertisment, în loc să eșueze.
  • options: opțiuni de sesiune și de runtime, tratate mai jos.
  • callback: apelat ca callback('xuda_ready', SESSION_ID, SESSION_OBJ) când aplicația este gata.

Pentru finalizarea montării, cel mai sigur hook este evenimentul on_mounted de pe document.body:

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

Opțiuni comune

Fiecare opțiune de mai jos se rezolvă prin același lanț de șase pași: mai întâi un parametru de query din URL, apoi un atribut al elementului rădăcină, apoi options.params[key], apoi options[key], apoi un cookie, apoi localStorage. De aceea o pagină Slim poate fi reconfigurată dintr-un query string, fără nicio schimbare de cod.

Cum știi că Slim funcționează

  • bundle-ul s-a încărcat
  • prog_id randează ceva vizibil
  • evenimentul on_mounted se declanșează
  • elementele de UI conduse de câmpuri încep să se comporte reactiv

Dacă se întâmplă toate patru, pagina este în regulă. Dacă nu se randează nimic, verifică în ordine: dacă bundle-ul s-a încărcat într-adevăr, dacă prog_id se potrivește cu un id real de template sau cu o cheie de program, dacă programul există în project_data.programs și dacă ținta de montare este un element real (sau lăsată intenționat pe seama fallback-ului la body).