Hoppa till innehållet
Verifierad

Xuda Slim

Den lätta ingången i webbläsaren till Xuda-runtime, utan att något projekt behöver laddas.

Xuda Slim är den lätta ytan för att skriva för och bädda in Xuda-runtime. Den är användbar när du vill ha Xudas reaktiva datakälla, direktiv, händelser och strukturtaggar, utan att börja från hela Xuda CLI-projektets form.

Slim är fortfarande Xuda, inte en annan runtime. Uttryck läser fortfarande fält med @field_name, runtime arbetar fortfarande utifrån Xudas programdokument, och strukturtaggar som xu-single-view och xu-panel spelar fortfarande roll. <template> stöds, men krävs inte.

Vad Slim är till för

  • handskrivna HTML-sidor med Xuda-reaktivitet
  • runtime-demon och dokumentation
  • inbäddningsbara widgets eller mikrowebbplatser
  • genererade project_data-runtimeträd
  • stegvis införande av Xuda utan att först behöva en fullständig källkompilator

De tre skrivlägena

Lägena kan blandas: om Slim får project_data och sidan också har <template>-taggar tolkas mallarna och läggs till i project_data.programs bredvid.

Ladda runtime

Det stödda sättet att få paketet är det publika npm-paketet @xuda.io/xuda-runtime-slim-es. Om du har en distribuerad Xuda-app serverar plattformen också runtime-paketet från din egen appdomän på /cdn, med en icke-minifierad version på /cdn/debug.

html
<script src="https://xuda.ai/dist/runtime/js/xuda-runtime-slim.js"></script>
Ladda inte från en utvecklingsvärd i produktion

Script-taggen ovan pekar på en utvecklingsvärd, användbar för att prova Slim lokalt. En distribuerad sida bör ladda @xuda.io/xuda-runtime-slim-es, eller servera paketet från din egen appdomän på /cdn.

Konstruktorn

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

Argumenten matchas efter typ, inte position: ett element, ett options-objekt och en callback kan skickas i valfri ordning.

  • element: DOM-elementet att montera i. Valfritt i Slim: utelämna det så faller runtime tillbaka på document.body och loggar en varning i stället för att misslyckas.
  • options: sessions- och runtimealternativ, beskrivs nedan.
  • callback: anropas som callback('xuda_ready', SESSION_ID, SESSION_OBJ) när appen är klar.

För att veta när monteringen är klar är den mest tillförlitliga kroken händelsen on_mounted på document.body:

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

Vanliga alternativ

Varje alternativ nedan löses genom samma sexstegskedja: först en URL-frågeparameter, sedan ett attribut på rotelementet, sedan options.params[key], sedan options[key], sedan en cookie och sist localStorage. Därför kan en Slim-sida konfigureras om från en frågesträng utan kodändring.

Så vet du att Slim fungerar

  • paketet laddades
  • ditt prog_id visar något synligt
  • händelsen on_mounted utlöses
  • fältstyrda gränssnittsuppdateringar börjar bete sig reaktivt

Om alla fyra inträffar är sidan i gott skick. Om inget visas, kontrollera i ordning: att paketet verkligen laddades, att prog_id matchar ett riktigt mall-id eller en programnyckel, att programmet finns i project_data.programs och att monteringsmålet är ett riktigt element (eller medvetet lämnat åt body-reservlösningen).