Bindings y acciones
Bindings
Cada propiedad puede contener un binding: {{ expresión }}. Solo, conserva el tipo del resultado (número, lista, sí/no); dentro de un texto se inserta como texto – p. ej. Hola {{user.email}} o {{query.tasks.total}} tareas.
Las expresiones son un subconjunto seguro de JavaScript, sin eval: números, textos, true/false/null, listas […], objetos {…}, a.b, a[b], a?.b, ! - + * / %, comparaciones, && || ??, condición ? a : b y llamadas a las funciones auxiliares y a algunos métodos de texto/lista (toUpperCase, includes, slice, join …). No hay window, ni fetch, ni funciones propias.
| Nombre | Contenido |
|---|---|
state.<nombre> |
variables de la app (pestaña App → Variables) |
el.<id> |
valores de los elementos (consulta Elementos) |
query.<nombre> |
records, record, total, loading, error, data de la última ejecución |
url.<nombre> |
parámetros en la dirección de la página |
user |
id, email, role – null en apps públicas sin sesión |
page, app |
página actual (id, name, path), app (name, slug) |
row, item, values, value |
en eventos: fila seleccionada, entrada, valores del formulario, valor nuevo |
Funciones auxiliares: len, upper, lower, str, num, round(x, decimales), min, max, json, isEmpty, contains, first, pluck(lista, campo), sum(lista, campo), count, now, today, date, datetime, number(x, decimales), currency(x, 'EUR', decimales), fileUrl(consulta, archivo, miniatura) – la dirección de un archivo de una columna de adjuntos (archivo = ID del archivo o el propio campo de adjuntos, miniatura = la vista previa), p. ej. <img src="{{fileUrl('references', item.cover, true)}}"> o como destino de Abrir enlace. La consulta debe ser una consulta de lectura de la app que llegue a la tabla del archivo – fechas y números en el idioma de la interfaz.
En la vista previa del borrador, una barra arriba enumera los bindings con errores.
Acciones
Los eventos (clic, envío, selección, cambio, entrada de menú) ejecutan pasos uno tras otro. Cada paso puede tener una condición Solo si. Si una consulta falla, la cadena se detiene con un mensaje.
| Paso | Parámetros |
|---|---|
| Ejecutar consulta | consulta, parámetros, formulario (sus valores como parámetros) |
| Recargar consulta | consulta (con los últimos parámetros) |
| Fijar variable | nombre, valor |
| Abrir página | página, parámetros (en la dirección) |
| Abrir / cerrar diálogo | diálogo |
| Mostrar mensaje | texto, tipo (info, ok, error) |
| Abrir enlace | dirección (http(s), mailto, tel o ruta), nueva pestaña |
| Vaciar formulario | formulario |
| Rellenar formulario | Formulario, valores (objeto nombre → valor, p. ej. {{query.record.record}}); cada entrada toma el valor de su nombre o de su campo |
| Exportar CSV | Elemento (tabla, lista o gráfico de la página actual); descarga sus datos como CSV, como el botón CSV |
| Pedir confirmación | Título, texto, texto del botón, peligrosa; detiene la cadena si se cancela |
| Script | instrucciones |
Scripts
Un script consta de instrucciones separadas por saltos de línea o ;: asignaciones a state.… y el.<id>.value (también +=, -=) e if (…) { … } else { … }. Se ejecuta en el navegador en el mismo entorno aislado que los bindings. Ejemplo de interruptor:
state.onlyOpen = !state.onlyOpen
if (!state.onlyOpen) { el.search.value = '' }
Editor grande: el icono ⤢ junto a Script abre el editor de código en una ventana grande – con resaltado, números de línea y comprobación de la sintaxis mientras escribes (el error se subraya donde está, arriba se indica la línea). Ctrl+Espacio sugiere nombres: tras state. las variables de la app, tras el. los elementos, tras query. las consultas y, si no, las funciones. Aplicar (o Ctrl+S) devuelve el script, Cancelar descarta los cambios. El mismo icono está junto al campo HTML del elemento HTML: con resaltado HTML y autocompletado de etiquetas; los marcadores {{ … }} se comprueban y completan (Ctrl+Espacio dentro de {{ propone record, state., el., query. y las funciones).
La lógica que necesita datos de otras tablas o sistemas externos va en el servidor: en un workflow o un endpoint personalizado.