Manuale · 8

Binding e azioni

Binding

Ogni proprietà può contenere un binding: {{ espressione }}. Da solo mantiene il tipo del risultato (numero, elenco, sì/no); dentro un testo viene inserito come testo – es. Ciao {{user.email}} o {{query.tasks.total}} attività.

Le espressioni sono un sottoinsieme sicuro di JavaScript, senza eval: numeri, testi, true/false/null, liste […], oggetti {…}, a.b, a[b], a?.b, ! - + * / %, confronti, && || ??, condizione ? a : b e chiamate delle funzioni di aiuto e di alcuni metodi di testo/lista (toUpperCase, includes, slice, join …). Non ci sono window, fetch né funzioni proprie.

Nome Contenuto
state.<nome> variabili dell’app (scheda App → Variabili)
el.<id> valori degli elementi (vedi Elementi)
query.<nome> records, record, total, loading, error, data dell’ultima esecuzione
url.<nome> parametri nell’indirizzo della pagina
user id, email, role – null nelle app pubbliche senza accesso
page, app pagina attuale (id, name, path), app (name, slug)
row, item, values, value negli eventi: riga selezionata, voce, valori del modulo, nuovo valore

Funzioni di aiuto: len, upper, lower, str, num, round(x, decimali), min, max, json, isEmpty, contains, first, pluck(lista, campo), sum(lista, campo), count, now, today, date, datetime, number(x, decimali), currency(x, 'EUR', decimali), fileUrl(query, file, anteprima) – l’indirizzo di un file di una colonna allegati (file = ID del file o il campo allegato stesso, anteprima = l’immagine di anteprima), ad es. <img src="{{fileUrl('references', item.cover, true)}}"> o come destinazione di Apri link. La query deve essere una query di lettura dell’app che raggiunge la tabella del file – date e numeri nella lingua dell’interfaccia.

Nell’anteprima della bozza una barra in alto elenca i binding errati.

Azioni

Gli eventi (clic, invio, selezione, modifica, voce di menu) eseguono passi uno dopo l’altro. Ogni passo può avere una condizione Solo se. Se una query fallisce, la catena si ferma con un messaggio.

Passo Parametri
Esegui query query, parametri, modulo (i suoi valori come parametri)
Ricarica query query (con gli ultimi parametri)
Imposta variabile nome, valore
Apri pagina pagina, parametri (nell’indirizzo)
Apri / chiudi finestra finestra
Mostra messaggio testo, tipo (info, ok, error)
Apri link indirizzo (http(s), mailto, tel o percorso), nuova scheda
Svuota modulo modulo
Compila modulo Modulo, valori (oggetto nome → valore, p. es. {{query.record.record}}); ogni input prende il valore del suo nome o del suo campo
Esporta CSV Elemento (tabella, elenco o grafico della pagina attuale); scarica i suoi dati come CSV, come il pulsante CSV
Chiedi conferma Titolo, testo, etichetta del pulsante, pericolosa; interrompe la catena se si annulla
Script istruzioni

Script

Uno script è fatto di istruzioni separate da a capo o ;: assegnazioni a state.… e el.<id>.value (anche +=, -=) e if (…) { … } else { … }. Gira nel browser nella stessa sandbox dei binding. Esempio di interruttore:

state.onlyOpen = !state.onlyOpen
if (!state.onlyOpen) { el.search.value = '' }

Editor grande: l’icona ⤢ accanto a Script apre l’editor di codice in una finestra grande – con evidenziazione, numeri di riga e controllo della sintassi mentre scrivi (l’errore è sottolineato dove si trova, la riga è indicata in alto). Ctrl+Spazio propone i nomi: dopo state. le variabili dell’app, dopo el. gli elementi, dopo query. le query, altrimenti le funzioni. Applica (o Ctrl+S) riporta lo script, Annulla scarta le modifiche. La stessa icona si trova accanto al campo HTML dell’elemento HTML: con evidenziazione HTML e completamento dei tag; i segnaposto {{ … }} vengono controllati e completati (Ctrl+Spazio dentro {{ propone record, state., el., query. e le funzioni).

La logica che ha bisogno di dati di altre tabelle o di sistemi esterni va sul server: in un workflow o in un endpoint personalizzato.