Hopp til innholdet
Bekreftet

HTML-skriving i Slim

Skriv vanlig HTML, legg til Xuda-direktiver, og la Slim gjøre det om til et programtre.

HTML-skriving er den mest direkte måten å lære Slim på. I stedet for en kompilator skriver du vanlig HTML og legger til Xuda-direktiver som binder felt, beregner utdata, skifter synlighet, kjører handlinger eller går gjennom data.

Mental modell

  • vanlig HTML for struktur
  • datakildefelt for tilstand
  • @field_name-uttrykk for lesing
  • Xuda-direktiver for å koble opp atferd
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>

Hvordan <template> blir et program

Når siden inneholder <template>-tagger, leser Slim hver av dem, bruker malens id-attributt som program-ID (eller template_<index> når det ikke finnes noen id), tolker markupen til progUi og lagrer resultatet under _session.project_data.programs. Hvis ingen prog_id er oppgitt, blir den første malen på siden oppstartsprogrammet.

Maler er valgfrie. Hvis du allerede sender inn project_data, utvider malene de dataene i stedet for å erstatte dem.

Vanlige HTML-direktiver

Den fullstendige direktivreferansen, med uttrykk og hendelser, finner du under Kjøretidsdirektiver.

Tolking av attributtverdier

Malattributter som ser ut som JSON, en matrise ([...]), et objekt ({...}) eller en JSON-streng i anførselstegn, tolkes med JSON.parse. En gyldig verdi blir et ekte objekt eller en ekte matrise i progUi; en ugyldig blir værende en vanlig streng. xu-store er unntaket: håndtereren tolker med JSON5, så JSON5-syntaks (nøkler uten anførselstegn, enkle anførselstegn) fungerer fortsatt der.

Når HTML-skriving passer best

Bruk den til dokumentasjonssider, mikronettsteder, landingssider for produkter, widgeter som bygges inn og prototyper skrevet for hånd. Gå over til CLI-et når appen vokser til flere rutede funksjoner, lagringslogikken trenger et tydeligere hjem, eller flere enhetstyper som get_data, set_data og batch bør ligge utenfor siden.