Bindungen und Aktionen
Bindungen
Jede Eigenschaft kann eine Bindung enthalten: {{ ausdruck }}. Steht sie allein, behält sie den Typ des Ergebnisses (Zahl, Liste, Ja/Nein); in Text eingebettet wird sie als Text eingesetzt – z. B. Hallo {{user.email}} oder {{query.tasks.total}} Aufgaben.
Ausdrücke sind ein sicherer Ausschnitt von JavaScript, ohne eval: Zahlen, Texte, true/false/null, Listen […], Objekte {…}, a.b, a[b], a?.b, ! - + * / %, Vergleiche, && || ??, bedingung ? a : b und Aufrufe der Hilfsfunktionen und einiger Text-/Listen-Methoden (toUpperCase, includes, slice, join …). Es gibt kein window, kein fetch und keine eigenen Funktionen.
| Name | Inhalt |
|---|---|
state.<name> |
App-Variablen (Reiter App → Variablen) |
el.<id> |
Werte der Elemente (siehe Steuerelemente) |
query.<name> |
records, record, total, loading, error, data der letzten Ausführung |
url.<name> |
Parameter in der Adresse der Seite |
user |
id, email, role – null in öffentlichen Apps ohne Anmeldung |
page, app |
aktuelle Seite (id, name, path), App (name, slug) |
row, item, values, value |
im Ereignis: gewählte Zeile, Eintrag, Formularwerte, neuer Wert |
Hilfsfunktionen: len, upper, lower, str, num, round(x, stellen), min, max, json, isEmpty, contains, first, pluck(liste, feld), sum(liste, feld), count, now, today, date, datetime, number(x, stellen), currency(x, 'EUR', stellen), fileUrl(abfrage, datei, vorschau) – Adresse einer Datei aus einer Anhang-Spalte (datei = Datei-ID oder das Anhang-Feld selbst, vorschau = Vorschaubild), z. B. <img src="{{fileUrl('referenzen', item.cover, true)}}"> oder als Ziel von Link öffnen. Die Abfrage muss eine lesende der App sein, die die Tabelle der Datei erreicht – Datum und Zahlen in der Sprache der Oberfläche.
In der Vorschau des Entwurfs listet ein Balken oben fehlerhafte Bindungen.
Aktionen
Ereignisse (Klick, Absenden, Auswahl, Änderung, Menüeintrag) führen Schritte nacheinander aus. Jeder Schritt kann eine Bedingung Nur wenn haben. Schlägt eine Abfrage fehl, endet die Kette mit einer Meldung.
| Schritt | Parameter |
|---|---|
| Abfrage ausführen | Abfrage, Parameter, Formular (dessen Werte als Parameter) |
| Abfrage neu laden | Abfrage (mit den letzten Parametern) |
| Variable setzen | Name, Wert |
| Seite öffnen | Seite, Parameter (in der Adresse) |
| Dialog öffnen / schließen | Dialog |
| Meldung zeigen | Text, Art (info, ok, error) |
| Link öffnen | Adresse (http(s), mailto, tel oder Pfad), neuer Tab |
| Formular leeren | Formular |
| Formular füllen | Formular, Werte (Objekt Name → Wert, z. B. {{query.eintrag.record}}); jedes Eingabefeld nimmt den Wert seines Namens oder seines Felds |
| CSV exportieren | Element (Tabelle, Liste oder Diagramm auf der aktuellen Seite); lädt dessen Daten als CSV herunter, wie der Knopf CSV |
| Rückfrage | Titel, Text, Beschriftung des Knopfs, gefährlich; bricht die Kette ab, wenn abgebrochen wird |
| Skript | Anweisungen |
Skripte
Ein Skript besteht aus Anweisungen, getrennt durch Zeilenumbruch oder ;: Zuweisungen an state.… und el.<id>.value (auch +=, -=) und if (…) { … } else { … }. Es läuft im Browser in derselben Sandbox wie Bindungen. Beispiel für einen Umschalter:
state.onlyOpen = !state.onlyOpen
if (!state.onlyOpen) { el.search.value = '' }
Großer Editor: Das Symbol ⤢ neben Skript öffnet den Code-Editor im großen Fenster – mit Hervorhebung, Zeilennummern und Prüfung der Syntax während des Tippens (der Fehler wird an der Stelle unterstrichen, oben steht die Zeile). Strg+Leertaste schlägt Namen vor: nach state. die App-Variablen, nach el. die Elemente, nach query. die Abfragen, sonst die Hilfsfunktionen. Übernehmen (oder Strg+S) schreibt das Skript zurück, Abbrechen verwirft die Änderungen. Dasselbe Symbol steht am Feld HTML des HTML-Elements: dort mit HTML-Hervorhebung und Tag-Vervollständigung; geprüft und ergänzt werden die {{ … }}-Platzhalter (Strg+Leertaste innerhalb von {{ schlägt record, state., el., query. und die Hilfsfunktionen vor).
Logik, die Daten anderer Tabellen oder fremde Systeme braucht, gehört auf den Server: in einen Workflow oder einen Custom Endpoint.