Hopp til innholdet
Bekreftet

Xuda Slim

Det lette nettleserinngangspunktet til Xuda-kjøretiden, uten prosjektlaster.

Xuda Slim er den lette flaten for å skrive og bygge inn Xuda-kjøretiden. Den er nyttig når du vil ha Xudas reaktive datakilde, direktiver, hendelser og strukturtagger, uten å begynne med den fulle prosjektformen til Xuda CLI.

Slim er fortsatt Xuda, ikke en annen kjøretid. Uttrykk leser fortsatt felt med @field_name, kjøretiden jobber fortsatt ut fra Xuda-programdokumenter, og strukturtagger som xu-single-view og xu-panel betyr fortsatt noe. <template> støttes, men er ikke påkrevd.

Hva Slim er til for

  • HTML-sider skrevet for hånd, med Xuda-reaktivitet
  • kjøretidsdemoer og dokumentasjon
  • widgeter eller mikronettsteder som kan bygges inn
  • genererte project_data-kjøretidstrær
  • gradvis innføring av Xuda uten å først måtte ta i bruk en full kildekompilator

De tre skrivemåtene

Disse skrivemåtene kan blandes: hvis Slim får project_data og siden også har <template>-tagger, tolkes malene og legges til i project_data.programs ved siden av.

Laste kjøretiden

Den støttede måten å få tak i pakken på er den offentlige npm-pakken @xuda.io/xuda-runtime-slim-es. Hvis du har en distribuert Xuda-app, serverer plattformen også kjøretidspakken fra ditt eget app-domene på /cdn, med en uminifisert versjon på /cdn/debug.

html
<script src="https://xuda.ai/dist/runtime/js/xuda-runtime-slim.js"></script>
Ikke last fra en utviklingsvert i produksjon

Script-taggen ovenfor peker på en utviklingsvert, nyttig for å prøve Slim lokalt. En distribuert side bør laste @xuda.io/xuda-runtime-slim-es, eller servere pakken fra ditt eget app-domene på /cdn.

Konstruktøren

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

Argumentene matches etter type, ikke posisjon: et element, et valgobjekt og en callback kan sendes inn i hvilken som helst rekkefølge.

  • element: DOM-elementet det skal monteres i. Valgfritt i Slim: utelat det, så faller kjøretiden tilbake til document.body og logger en advarsel i stedet for å feile.
  • options: økt- og kjøretidsvalg, beskrevet nedenfor.
  • callback: kalles som callback('xuda_ready', SESSION_ID, SESSION_OBJ) når appen er klar.

For å vite at monteringen er ferdig er den mest pålitelige kroken on_mounted-hendelsen på document.body:

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

Vanlige valg

Hvert valg nedenfor løses gjennom den samme kjeden i seks trinn: først en URL-spørringsparameter, så et attributt på rotelementet, så options.params[key], så options[key], så en informasjonskapsel, så localStorage. Det er derfor en Slim-side kan konfigureres på nytt fra en spørrestreng uten kodeendring.

Slik vet du at Slim virker

  • pakken ble lastet
  • prog_id viser noe synlig
  • on_mounted-hendelsen utløses
  • feltdrevet brukergrensesnitt begynner å oppdatere seg reaktivt

Hvis alle fire skjer, er siden i god stand. Hvis ingenting vises, sjekk i denne rekkefølgen: at pakken faktisk ble lastet, at prog_id samsvarer med en ekte mal-ID eller programnøkkel, at programmet finnes i project_data.programs, og at monteringsmålet er et ekte element (eller med vilje overlatt til body-reserveløsningen).