Saltar al contenido
Verificada

Creación en HTML con Slim

Escribe HTML normal, añade directivas de Xuda y deja que Slim lo convierta en un árbol de programa.

La creación en HTML es la forma más directa de aprender Slim. En lugar de un compilador, escribes HTML normal y añades directivas de Xuda que enlazan campos, calculan una salida, alternan la visibilidad, ejecutan acciones o iteran sobre datos.

Modelo mental

  • HTML normal para la estructura
  • campos del datasource para el estado
  • expresiones @field_name para las lecturas
  • directivas de Xuda para conectar el comportamiento
html
<div xu-store="{'headline':'Hello Xuda'}">
  <input xu-bind="headline" />
  <h1 xu-exp:xu-content="@headline"></h1>
</div>

Una página completa

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>

Cómo se convierte <template> en un programa

Cuando la página contiene etiquetas <template>, Slim lee todas, usa el atributo id de la plantilla como id del programa (o template_<index> cuando no hay id), analiza el marcado en progUi y guarda el resultado bajo _session.project_data.programs. Si no se proporciona prog_id, la primera plantilla de la página se convierte en el programa de arranque.

Las plantillas son opcionales. Si ya pasas project_data, las plantillas amplían esos datos en lugar de sustituirlos.

Directivas HTML habituales

La referencia completa de directivas, con expresiones y eventos, está en Directivas del runtime.

Análisis de los valores de atributo

Los atributos de plantilla que parecen JSON, un array ([...]), un objeto ({...}) o una cadena JSON entre comillas se analizan con JSON.parse. Uno válido se convierte en un objeto o array real en progUi; uno inválido sigue siendo una cadena simple. xu-store es la excepción: su manejador analiza con JSON5, así que la sintaxis de estilo JSON5 (claves sin comillas, comillas simples) sigue funcionando allí.

Cuándo es mejor la creación en HTML

Úsala para páginas de documentación, micrositios, páginas de aterrizaje de producto, widgets incrustados y prototipos escritos a mano. Pasa a la CLI cuando la app crezca hasta tener varias funciones con rutas, la lógica de persistencia necesite un lugar más claro o varios tipos de unidad como get_data, set_data y batch deban vivir fuera de la página.