Saltar para o conteúdo
Verificado

Escrita em HTML no Slim

Escreva HTML normal, adicione diretivas do Xuda e deixe o Slim transformá-lo numa árvore de programa.

A escrita em HTML é a forma mais direta de aprender o Slim. Em vez de um compilador, você escreve HTML normal e adiciona diretivas do Xuda que ligam campos, calculam saídas, alternam a visibilidade, executam ações ou iteram sobre dados.

Modelo mental

  • HTML normal para a estrutura
  • campos da datasource para o estado
  • expressões @field_name para as leituras
  • diretivas do Xuda para ligar o comportamento
html
<div xu-store="{'headline':'Hello Xuda'}">
  <input xu-bind="headline" />
  <h1 xu-exp:xu-content="@headline"></h1>
</div>

Uma 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>

Como o <template> se torna um programa

Quando a página contém tags <template>, o Slim lê todas elas, usa o atributo id do template como id do programa (ou template_<index> quando não há id), analisa a marcação para progUi e guarda o resultado em _session.project_data.programs. Sem prog_id fornecido, o primeiro template da página torna-se o programa de arranque.

Os templates são opcionais. Se já passar project_data, os templates estendem esses dados em vez de os substituírem.

Diretivas HTML comuns

A referência completa das diretivas, incluindo expressões e eventos, está em Diretivas de runtime.

Análise de valores de atributos

Os atributos de template que parecem JSON, um array ([...]), um objeto ({...}) ou uma string JSON entre aspas são analisados com JSON.parse. Um válido torna-se um objeto ou array real em progUi; um inválido continua a ser uma string simples. O xu-store é a exceção: o seu tratador analisa com JSON5, por isso a sintaxe ao estilo JSON5 (chaves sem aspas, aspas simples) continua a funcionar aí.

Quando a escrita em HTML é a melhor opção

Use-a para páginas de documentação, microsites, páginas de destino de produtos, widgets incorporados e protótipos escritos à mão. Passe para a CLI quando a aplicação crescer para várias funcionalidades com rotas, quando a lógica de persistência precisar de um lugar mais claro, ou quando vários tipos de unidade, como get_data, set_data e batch, devam ficar fora da página.