Gå til indhold
Bekræftet

Xuda Slim

Det lette browserindgangspunkt til Xuda-runtime, uden en projektindlæser.

Xuda Slim er den lette flade til at skrive og indlejre Xuda-runtime. Den er nyttig, når du vil have Xudas reaktive datakilde, direktiver, hændelser og strukturelle tags, uden at starte fra den fulde Xuda CLI-projektstruktur.

Slim er stadig Xuda, ikke en anden runtime. Udtryk læser stadig felter med @field_name, runtime arbejder stadig ud fra Xuda-programdokumenter, og strukturelle tags som xu-single-view og xu-panel har stadig betydning. <template> understøttes, men er ikke påkrævet.

Hvad Slim bruges til

  • håndskrevne HTML-sider med Xuda-reaktivitet
  • runtime-demoer og dokumentation
  • widgets eller mikrosites, der kan indlejres
  • genererede project_data-runtimetræer
  • gradvis indførelse af Xuda uden først at indføre en fuld kildekompiler

De tre skrivemåder

Disse tilstande kan blandes: hvis Slim modtager project_data, og siden også har <template>-tags, parses skabelonerne og lægges ind i project_data.programs ved siden af.

Indlæsning af runtime

Den understøttede måde at hente bundlet på er den offentlige npm-pakke @xuda.io/xuda-runtime-slim-es. Hvis du har en udrullet Xuda-app, serverer platformen også runtime-bundlet fra dit eget app-domæne på /cdn, med en ikke-minificeret udgave på /cdn/debug.

html
<script src="https://xuda.ai/dist/runtime/js/xuda-runtime-slim.js"></script>
Indlæs ikke fra en udviklingsvært i produktion

Script-tagget ovenfor peger på en udviklingsvært, nyttig til at prøve Slim lokalt. En udrullet side bør indlæse @xuda.io/xuda-runtime-slim-es eller servere bundlet fra dit eget app-domæne på /cdn.

Konstruktøren

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

Argumenter matches efter type, ikke position: et element, et options-objekt og en callback kan angives i vilkårlig rækkefølge.

  • element: det DOM-element, der skal monteres i. Valgfrit i Slim: udelad det, og runtime falder tilbage til document.body og logger en advarsel i stedet for at fejle.
  • options: session- og runtime-indstillinger, beskrevet nedenfor.
  • callback: kaldes som callback('xuda_ready', SESSION_ID, SESSION_OBJ), når appen er klar.

Den mest pålidelige krog til at vide, at monteringen er færdig, er hændelsen on_mounted på document.body:

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

Almindelige indstillinger

Hver indstilling nedenfor løses gennem den samme kæde i seks trin: først en URL-forespørgselsparameter, så en attribut på rodelementet, så options.params[key], så options[key], så en cookie og til sidst localStorage. Derfor kan en Slim-side konfigureres om fra en forespørgselsstreng uden kodeændring.

Sådan ved du, at Slim virker

  • bundlet er indlæst
  • din prog_id viser noget synligt
  • hændelsen on_mounted udløses
  • feltdrevet brugerflade begynder at opføre sig reaktivt

Hvis alle fire sker, er siden i orden. Hvis intet vises, så tjek i rækkefølge: at bundlet faktisk blev indlæst, at prog_id matcher et rigtigt skabelon-id eller en programnøgle, at programmet findes i project_data.programs, og at monteringsmålet er et rigtigt element (eller bevidst overladt til body-fallback).