Przejdź do treści
Zweryfikowano

Tworzenie w HTML w Slim

Pisz zwykły HTML, dodawaj dyrektywy Xuda i pozwól Slim zamienić go w drzewo programu.

Tworzenie w HTML to najbardziej bezpośredni sposób nauki Slim. Zamiast kompilatora piszesz zwykły HTML i dodajesz dyrektywy Xuda, które wiążą pola, obliczają wynik, przełączają widoczność, uruchamiają akcje lub iterują po danych.

Model myślowy

  • zwykły HTML dla struktury
  • pola źródła danych dla stanu
  • wyrażenia @field_name do odczytu
  • dyrektywy Xuda do podłączania zachowań
html
<div xu-store="{'headline':'Hello Xuda'}">
  <input xu-bind="headline" />
  <h1 xu-exp:xu-content="@headline"></h1>
</div>

Cała strona

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>

Jak <template> staje się programem

Gdy strona zawiera tagi <template>, Slim czyta każdy z nich, używa atrybutu id szablonu jako identyfikatora programu (albo template_<index>, gdy nie ma identyfikatora), parsuje znaczniki do progUi i zapisuje wynik w _session.project_data.programs. Gdy nie podano prog_id, programem startowym zostaje pierwszy szablon na stronie.

Szablony są opcjonalne. Jeśli już przekazujesz project_data, szablony rozszerzają te dane, a nie je zastępują.

Typowe dyrektywy HTML

Pełna dokumentacja dyrektyw, w tym wyrażeń i zdarzeń, jest w Dyrektywach środowiska.

Parsowanie wartości atrybutów

Atrybuty szablonu, które wyglądają jak JSON, tablica ([...]), obiekt ({...}) lub ciąg JSON w cudzysłowie, są parsowane przez JSON.parse. Poprawny staje się prawdziwym obiektem lub tablicą w progUi, a niepoprawny zostaje zwykłym ciągiem. Wyjątkiem jest xu-store: jego obsługa parsuje JSON5, więc składnia w stylu JSON5 (klucze bez cudzysłowów, apostrofy) nadal tam działa.

Kiedy tworzenie w HTML pasuje lepiej

Używaj go do stron dokumentacji, mikrowitryn, stron produktowych, osadzanych widżetów i ręcznie pisanych prototypów. Przejdź do CLI, gdy aplikacja urośnie do wielu funkcji z trasami, logika zapisu danych będzie potrzebować wyraźniejszego miejsca albo kilka typów jednostek, takich jak get_data, set_data i batch, ma żyć poza stroną.