Przejdź do treści
Zweryfikowano

Xuda Slim

Lekki punkt wejścia do środowiska Xuda w przeglądarce, bez ładowania projektu.

Xuda Slim to lekka powierzchnia do tworzenia i osadzania dla środowiska uruchomieniowego Xuda. Jest przydatna, gdy chcesz mieć reaktywne źródło danych, dyrektywy, zdarzenia i tagi strukturalne Xuda, bez zaczynania od pełnego kształtu projektu Xuda CLI.

Slim to nadal Xuda, a nie inne środowisko. Wyrażenia nadal czytają pola przez @field_name, środowisko nadal pracuje na dokumentach programów Xuda, a tagi strukturalne, takie jak xu-single-view i xu-panel, nadal mają znaczenie. <template> jest obsługiwany, ale nie jest wymagany.

Do czego służy Slim

  • ręcznie pisane strony HTML z reaktywnością Xuda
  • demonstracje środowiska i dokumentacja
  • osadzane widżety lub mikrowitryny
  • wygenerowane drzewa uruchomieniowe project_data
  • stopniowe wdrażanie Xuda bez wprowadzania najpierw pełnego kompilatora źródeł

Trzy tryby tworzenia

Tryby można mieszać: jeśli Slim dostanie project_data, a strona ma też tagi <template>, szablony są parsowane i dodawane do project_data.programs obok niego.

Ładowanie środowiska

Obsługiwany sposób pobrania pakietu to publiczny pakiet npm @xuda.io/xuda-runtime-slim-es. Jeśli masz wdrożoną aplikację Xuda, platforma serwuje też pakiet środowiska z Twojej własnej domeny aplikacji pod /cdn, a wersję niezminifikowaną pod /cdn/debug.

html
<script src="https://xuda.ai/dist/runtime/js/xuda-runtime-slim.js"></script>
Nie ładuj z hosta deweloperskiego w produkcji

Powyższy tag script wskazuje host deweloperski, przydatny do lokalnego wypróbowania Slim. Wdrożona strona powinna ładować @xuda.io/xuda-runtime-slim-es albo serwować pakiet z własnej domeny aplikacji pod /cdn.

Konstruktor

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

Argumenty są dopasowywane według typu, a nie pozycji: element, obiekt opcji i callback można podać w dowolnej kolejności.

  • element: element DOM, w którym ma nastąpić montowanie. Opcjonalny w Slim: pomiń go, a środowisko użyje document.body i zapisze ostrzeżenie zamiast zakończyć się błędem.
  • options: opcje sesji i środowiska, omówione niżej.
  • callback: wywoływany jako callback('xuda_ready', SESSION_ID, SESSION_OBJ), gdy aplikacja jest gotowa.

Najpewniejszy haczyk na zakończenie montowania to zdarzenie on_mounted na document.body:

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

Typowe opcje

Każda z poniższych opcji jest rozstrzygana tym samym sześciostopniowym łańcuchem: najpierw parametr zapytania URL, potem atrybut elementu głównego, potem options.params[key], potem options[key], potem cookie, potem localStorage. Dlatego stronę Slim można przekonfigurować z ciągu zapytania bez zmiany kodu.

Skąd wiesz, że Slim działa

  • pakiet się załadował
  • Twój prog_id wyświetla coś widocznego
  • zdarzenie on_mounted się uruchamia
  • UI sterowane polami zaczyna zachowywać się reaktywnie

Jeśli zdarzą się wszystkie cztery rzeczy, strona jest w dobrym stanie. Jeśli nic się nie wyświetla, sprawdź po kolei: czy pakiet faktycznie się załadował, czy prog_id pasuje do prawdziwego identyfikatora szablonu lub klucza programu, czy program istnieje w project_data.programs i czy cel montowania jest prawdziwym elementem (albo celowo zostawiony rozwiązaniu zapasowemu z body).