Gå til indhold
Bekræftet

HTML-forfatning i Slim

Skriv almindelig HTML, tilføj Xuda-direktiver, og lad Slim gøre det til et programtræ.

HTML-forfatning er den mest direkte måde at lære Slim på. I stedet for en kompiler skriver du almindelig HTML og tilføjer Xuda-direktiver, der binder felter, beregner output, skifter synlighed, kører handlinger eller gennemløber data.

Mental model

  • almindelig HTML til strukturen
  • datakildefelter til tilstanden
  • @field_name-udtryk til at læse
  • Xuda-direktiver til at koble adfærd på
html
<div xu-store="{'headline':'Hello Xuda'}">
  <input xu-bind="headline" />
  <h1 xu-exp:xu-content="@headline"></h1>
</div>

En hel side

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>

Sådan bliver <template> til et program

Når siden indeholder <template>-tags, læser Slim hver eneste af dem, bruger skabelonens id-attribut som program-id (eller template_<index>, hvis der ikke er noget id), parser markup'en til progUi og gemmer resultatet under _session.project_data.programs. Hvis der ikke angives nogen prog_id, bliver den første skabelon på siden startprogrammet.

Skabeloner er valgfrie. Hvis du allerede sender project_data, udvider skabelonerne de data i stedet for at erstatte dem.

Almindelige HTML-direktiver

Den fulde direktivreference, inklusive udtryk og hændelser, findes under Runtime-direktiver.

Parsing af attributværdier

Skabelonattributter, der ligner JSON, et array ([...]), et objekt ({...}) eller en JSON-streng i anførselstegn, parses med JSON.parse. En gyldig bliver et rigtigt objekt eller array i progUi, og en ugyldig forbliver en almindelig streng. xu-store er undtagelsen: dens handler parser med JSON5, så syntaks i JSON5-stil (nøgler uden anførselstegn, enkelte anførselstegn) stadig virker der.

Hvornår HTML-forfatning passer bedst

Brug den til dokumentationssider, mikrosites, landingssider til produkter, widgets, der kan indlejres, og håndskrevne prototyper. Gå videre til CLI'en, når appen vokser til flere funktioner med ruter, når lagringslogik har brug for et tydeligere hjem, eller når flere enhedstyper som get_data, set_data og batch skal ligge uden for siden.