Handbuch · 8

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.