Saltar al contenido
Verificada

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_data generados
  • 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.

html
<script src="https://xuda.ai/dist/runtime/js/xuda-runtime-slim.js"></script>
No cargues desde un host de desarrollo en producción

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

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

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 a document.body y registra una advertencia en lugar de fallar.
  • options: opciones de sesión y de runtime, que se tratan más abajo.
  • callback: se llama como callback('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:

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

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_id muestra algo visible
  • el evento on_mounted se 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).