Manual · 8

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.