Xuda Slim
El punto de entrada ligero del navegador al runtime de Xuda, sin necesidad de cargador de proyectos.
Xuda Slim es la superficie ligera de creación e incrustación para el runtime de Xuda. Es útil cuando quieres el datasource reactivo, las directivas, los eventos y las etiquetas estructurales de Xuda, sin partir de la estructura completa de un proyecto de Xuda CLI.
Slim sigue siendo Xuda, no un runtime distinto. Las expresiones siguen leyendo campos con @field_name, el runtime sigue trabajando a partir de documentos de programa de Xuda, y las etiquetas estructurales como xu-single-view y xu-panel siguen importando. <template> está admitido, pero no es obligatorio.
Para qué sirve Slim
- páginas HTML escritas a mano con reactividad de Xuda
- demos del runtime y documentación
- widgets incrustables o micrositios
- árboles de runtime
project_datagenerados - adopción progresiva de Xuda sin introducir antes un compilador de código fuente completo
Los tres modos de creación
Estos modos se pueden mezclar: si Slim recibe project_data y la página también tiene etiquetas <template>, las plantillas se analizan y se añaden a project_data.programs junto con él.
Cargar el runtime
La forma admitida de obtener el paquete es el paquete público de npm @xuda.io/xuda-runtime-slim-es. Si tienes una app de Xuda desplegada, la plataforma también sirve el paquete del runtime desde el dominio de tu propia app en /cdn, con una versión sin minificar en /cdn/debug.
La etiqueta script anterior apunta a un host de desarrollo, útil para probar Slim en local. Una página desplegada debería cargar @xuda.io/xuda-runtime-slim-es, o servir el paquete desde el dominio de tu propia app en /cdn.
El constructor
Los argumentos se reconocen por tipo, no por posición: un elemento, un objeto de opciones y un callback se pueden pasar en cualquier orden.
element: el elemento del DOM en el que montar. Opcional en Slim: si lo omites, el runtime recurre adocument.bodyy registra una advertencia en lugar de fallar.options: opciones de sesión y de runtime, que se tratan más abajo.callback: se llama comocallback('xuda_ready', SESSION_ID, SESSION_OBJ)cuando la app está lista.
Para saber cuándo se completa el montaje, el gancho más fiable es el evento on_mounted en document.body:
Opciones habituales
Todas las opciones siguientes se resuelven por la misma cadena de seis pasos: primero un parámetro de consulta de la URL, después un atributo del elemento raíz, después options.params[key], después options[key], después una cookie y después localStorage. Por eso una página Slim se puede reconfigurar desde una cadena de consulta sin cambiar código.
Cómo saber que Slim funciona
- el paquete se cargó
- tu
prog_idmuestra algo visible - el evento
on_mountedse dispara - la UI guiada por campos empieza a comportarse de forma reactiva
Si ocurren las cuatro cosas, la página está bien. Si no se muestra nada, comprueba por orden: que el paquete se haya cargado de verdad, que prog_id coincida con un id de plantilla o una clave de programa reales, que el programa exista en project_data.programs y que el destino de montaje sea un elemento real (o se deje a propósito al recurso de body).