Siirry sisältöön
Tarkistettu

HTML-kirjoitus Slimissä

Kirjoita tavallista HTML:ää, lisää Xuda-direktiivit ja anna Slimin muuttaa se ohjelmapuuksi.

HTML-kirjoitus on suorin tapa oppia Slim. Kääntäjän sijaan kirjoitat tavallista HTML:ää ja lisäät Xuda-direktiivejä, jotka sitovat kenttiä, laskevat tulosteen, vaihtavat näkyvyyttä, ajavat toimintoja tai iteroivat dataa.

Mentaalimalli

  • tavallinen HTML rakenteelle
  • datalähteen kentät tilalle
  • @field_name-lausekkeet lukemiseen
  • Xuda-direktiivit käyttäytymisen kytkemiseen
html
<div xu-store="{'headline':'Hello Xuda'}">
  <input xu-bind="headline" />
  <h1 xu-exp:xu-content="@headline"></h1>
</div>

Täysi sivu

html
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8" />
  <script src="https://xuda.ai/dist/runtime/js/xuda-runtime-slim.js"></script>
  <script>
    document.addEventListener('DOMContentLoaded', () => {
      document.body.addEventListener('on_mounted', () => {
        console.log('HTML Slim page mounted');
      }, { once: true });

      const Xuda = globalThis.xuda?.xuda || globalThis.xuda;
      new Xuda(document.getElementById('app'), { domain: 'xuda.ai', prog_id: 'demo' });
    }, { once: true });
  </script>
</head>
<body>
  <div id="app"></div>

  <template id="demo">
    <div class="p-6" xu-store="{'title':'Hello from Slim HTML'}">
      <h1 xu-exp:xu-content="@title"></h1>
    </div>
  </template>
</body>
</html>

Miten <template> muuttuu ohjelmaksi

Kun sivu sisältää <template>-tageja, Slim lukee jokaisen niistä, käyttää mallin id-attribuuttia ohjelmatunnisteena (tai template_<index>, kun tunnistetta ei ole), jäsentää merkinnän progUi:ksi ja tallentaa tuloksen kohtaan _session.project_data.programs. Ilman annettua prog_id:tä sivun ensimmäisestä mallista tulee käynnistysohjelma.

Mallit ovat valinnaisia. Jos välität jo project_data:n, mallit laajentavat sitä sen korvaamisen sijaan.

Yleiset HTML-direktiivit

Täysi direktiiviviite, lausekkeet ja tapahtumat mukaan lukien, on sivulla Suoritusaikaiset direktiivit.

Attribuuttiarvojen jäsentäminen

Mallin attribuutit, jotka näyttävät JSONilta, taulukolta ([...]), oliolta ({...}) tai lainatulta JSON-merkkijonolta, jäsennetään JSON.parse:lla. Kelvollinen muuttuu oikeaksi olioksi tai taulukoksi kohdassa progUi, kelvoton pysyy tavallisena merkkijonona. xu-store on poikkeus: sen käsittelijä jäsentää JSON5:llä, joten JSON5-tyylinen syntaksi (lainaukseton avain, yksinkertaiset lainausmerkit) toimii siinä yhä.

Milloin HTML-kirjoitus sopii paremmin

Käytä sitä dokumentaatiosivuille, mikrosivustoille, tuotteiden laskeutumissivuille, upotetuille widgeteille ja käsin kirjoitetuille prototyypeille. Siirry CLI:hin, kun sovellus kasvaa useaksi reititetyksi toiminnoksi, tallennuslogiikka tarvitsee selkeämmän kodin tai useita yksikkötyyppejä kuten get_data, set_data ja batch pitäisi sijoittaa sivun ulkopuolelle.