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.