Siirry sisältöön
Tarkistettu

Xuda Slim

Kevyt selaimen sisäänkäynti Xudan suoritusympäristöön, ilman projektinlataajaa.

Xuda Slim on Xudan suoritusympäristön kevyt kirjoitus- ja upotuspinta. Se sopii, kun haluat Xudan reaktiivisen datalähteen, direktiivit, tapahtumat ja rakennetagit aloittamatta täydestä Xuda CLI -projektin muodosta.

Slim on yhä Xudaa, ei eri suoritusympäristö. Lausekkeet lukevat yhä kenttiä @field_name-muodossa, suoritusympäristö toimii yhä Xudan ohjelmadokumenteista, ja rakennetagit kuten xu-single-view ja xu-panel ovat yhä tärkeitä. <template> on tuettu, mutta ei pakollinen.

Mihin Slim sopii

  • käsin kirjoitetut HTML-sivut Xudan reaktiivisuudella
  • suoritusympäristön demot ja dokumentaatio
  • upotettavat widgetit tai mikrosivustot
  • generoidut project_data-suoritusaikaiset puut
  • Xudan asteittainen käyttöönotto ilman täyttä lähdekääntäjää alussa

Kolme kirjoitustapaa

Nämä tavat voi yhdistää: jos Slim saa project_data:n ja sivulla on myös <template>-tageja, mallit jäsennetään ja lisätään project_data.programs-kohtaan sen rinnalle.

Suoritusympäristön lataaminen

Tuettu tapa saada paketti on julkinen npm-paketti @xuda.io/xuda-runtime-slim-es. Jos sinulla on julkaistu Xuda-sovellus, alusta tarjoaa suoritusympäristön paketin myös omasta sovellusverkkotunnuksestasi osoitteesta /cdn, ja pakkaamaton koonti osoitteesta /cdn/debug.

html
<script src="https://xuda.ai/dist/runtime/js/xuda-runtime-slim.js"></script>
Älä lataa kehitysisännältä tuotannossa

Yllä oleva script-tagi osoittaa kehitysisäntään, mikä sopii Slimin kokeiluun paikallisesti. Julkaistun sivun tulee ladata @xuda.io/xuda-runtime-slim-es tai tarjoilla paketti omasta sovellusverkkotunnuksestasi osoitteesta /cdn.

Konstruktori

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

Argumentit tunnistetaan tyypin, ei paikan mukaan: elementin, asetusolion ja takaisinkutsun voi antaa missä järjestyksessä tahansa.

  • element: DOM-elementti, johon liitetään. Valinnainen Slimissä: jätä pois, niin suoritusympäristö käyttää document.body:a ja kirjaa varoituksen epäonnistumisen sijaan.
  • options: istunto- ja suoritusympäristön asetukset, katso alla.
  • callback: kutsutaan muodossa callback('xuda_ready', SESSION_ID, SESSION_OBJ), kun sovellus on valmis.

Liitoksen valmistumisen luotettavin koukku on on_mounted-tapahtuma elementillä document.body:

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

Yleiset asetukset

Jokainen alla oleva asetus ratkaistaan samalla kuusivaiheisella ketjulla: ensin URL-kyselyparametri, sitten attribuutti juurielementillä, sitten options.params[key], sitten options[key], sitten eväste, sitten localStorage. Siksi Slim-sivun voi määrittää uudelleen kyselymerkkijonosta ilman koodimuutosta.

Mistä tiedät, että Slim toimii

  • paketti latautui
  • prog_id renderöi jotain näkyvää
  • on_mounted-tapahtuma laukeaa
  • kenttäohjattu käyttöliittymä alkaa käyttäytyä reaktiivisesti

Jos kaikki neljä toteutuvat, sivu on kunnossa. Jos mitään ei renderöidä, tarkista järjestyksessä: paketti todella latautui, prog_id vastaa oikeaa mallin tunnistetta tai ohjelman avainta, ohjelma on olemassa kohdassa project_data.programs ja liitoskohde on oikea elementti (tai jätetty tarkoituksella body-varavaihtoehdon varaan).