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.
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
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żyjedocument.bodyi zapisze ostrzeżenie zamiast zakończyć się błędem.options: opcje sesji i środowiska, omówione niżej.callback: wywoływany jakocallback('xuda_ready', SESSION_ID, SESSION_OBJ), gdy aplikacja jest gotowa.
Najpewniejszy haczyk na zakończenie montowania to zdarzenie on_mounted na document.body:
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_idwyświetla coś widocznego - zdarzenie
on_mountedsię 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).