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_datageneraț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.
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
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 ladocument.bodyși loghează un avertisment, în loc să eșueze.options: opțiuni de sesiune și de runtime, tratate mai jos.callback: apelat cacallback('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:
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_idrandează ceva vizibil- evenimentul
on_mountedse 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).