Steuerelemente
Alle Eigenschaften lassen sich fest eintragen oder als Bindung {{ … }} berechnen. Jedes Element hat außerdem Sichtbar wenn (eine Bindung; leer = immer).
| Element | Eigenschaften | Ereignis |
|---|---|---|
| Überschrift | Text, Ebene 1–4, Ausrichtung | – |
| Text | Text, Markdown, gedämpft, Ausrichtung | – |
| Trenner | Beschriftung (optional), Ausrichtung der Beschriftung, Linie (durchgezogen, gestrichelt, gepunktet), senkrecht | – |
| Abstand | – (nur leerer Platz im Raster) | – |
| HTML | HTML mit Platzhaltern {{ … }}, optional Abfrage und Parameter (dann record und records), als Karte |
– |
| Bild | Bildadresse (URL), Alternativtext, Einpassen, abgerundet | – |
| Knopf | Beschriftung, Stil (primary, secondary, danger, ghost), Ausrichtung, volle Breite, gesperrt wenn | Klick |
| Eingabe | Beschriftung, Name, Art (Text, Zahl, E-Mail, Telefon, URL, Passwort, mehrzeilig), Platzhalter, Startwert, Pflichtfeld, gesperrt wenn, Hilfetext | Änderung |
| Auswahl | Beschriftung, Name, Optionen (eine pro Zeile) oder eine Abfrage mit Wert- und Beschriftungs-Feld, Platzhalter, Startwert, Pflichtfeld | Änderung |
| Datum | Beschriftung, Name, mit Uhrzeit, Startwert, Pflichtfeld | Änderung |
| Checkbox | Beschriftung, Name, Startwert | Änderung |
| Schalter | Beschriftung, Name, Startwert; wie eine Checkbox (Ja/Nein), als Kippschalter | Änderung |
| Optionen | Beschriftung, Name, Optionen oder Abfrage mit Wert- und Beschriftungs-Feld, nebeneinander, Startwert, Pflichtfeld – genau eine Wahl | Änderung |
| Mehrfachauswahl | wie Optionen, aber beliebig viele; der Wert ist eine Liste | Änderung |
| Schieberegler | Beschriftung, Name, Minimum, Maximum, Schritt, Einheit, Startwert; der Wert ist eine Zahl | Änderung |
| Bewertung | Beschriftung, Name, Maximum (5 Sterne), Startwert; ein Klick auf den aktuellen Stern leert sie, Pfeil links/rechts ändert sie | Änderung |
| Suchauswahl | Beschriftung, Name, Abfrage, Parameter, Such-Parameter (Standard q), Wert- und Beschriftungs-Feld, angezeigte Beschriftung, Platzhalter, Pflichtfeld |
Änderung |
| Datei | Beschriftung, Name, erlaubte Typen (z. B. image/*,.pdf), mehrere Dateien, Pflichtfeld, gesperrt wenn, Hilfetext; steht in einem Formular |
Änderung |
| Formular | Titel, Knopftext, nach dem Absenden leeren; enthält Eingaben | Absenden |
| Tabelle | Titel, Abfrage, Parameter, Spalten (Feld, Beschriftung, Format), Zeilen pro Seite, sortierbar, Text wenn leer | Auswahl |
| Detailansicht | Titel, Datensatz (Bindung, z. B. {{el.leadsTable.selected}}) oder Abfrage und Parameter, Felder (Feld, Beschriftung, Format; leer = alle), Spalten (1–4), leere Felder ausblenden, Text wenn leer |
– |
| Liste | Abfrage, Parameter, Titel/Text/Badge je Eintrag, Spalten 1–4, höchstens, Text wenn leer | Auswahl |
| Diagramm | Titel, Abfrage, Parameter, Art (Säulen, Balken quer, Linie, Fläche, Kreis, Ring), Beschriftungs-, Wert- und Reihen-Feld, zusammenfassen (je Datensatz, Anzahl, Summe, Mittelwert), gestapelt, Format der Werte (Zahl, Währung, Prozent, Stunden) | Auswahl |
| Kennzahl | Überschrift, Wert (Bindung) oder Abfrage mit Wert-Feld und Zusammenfassung (erster Datensatz, Anzahl, Summe, Mittelwert, Minimum, Maximum), Format (Zahl, Währung, Prozent, Stunden), Nachkommastellen, Einheit, Unterzeile, Vergleichen mit (zeigt die Änderung in % mit Pfeil), Text zum Vergleich, steigend ist gut/schlecht, Symbol | Klick |
| Kalender | Titel, Abfrage, Parameter, Start-, End- (optional), Titel- und Farb-Feld (Labelfarbe wie blue oder #hex), Ansicht Monat/Woche |
Auswahl, Klick auf einen Tag |
| Karte | Titel, Abfrage, Parameter, Art (Punkte, Flächen), Breiten-/Längengrad-Feld, Titel/Text je Punkt, Farb-Feld, nahe Punkte zusammenfassen, Flächen-Feld, Wert-Feld, zusammenfassen, Format, Grundkarte, Mitte, Zoom | Auswahl |
| Kanban | Titel, Abfrage, Parameter, Spalten-Feld, Spalten (Reihenfolge; leer = wie in den Daten), Titel/Text/Badge je Karte, Summen-Feld und Format, Text wenn leer | Auswahl, Verschieben |
| Galerie | Titel, Abfrage, Parameter, Bild-Feld (Anhang-Spalte oder Bildadresse), Titel/Text/Badge je Kachel, Spalten 2–6, Seitenverhältnis (quer, quadratisch, hoch), Einpassen, Text wenn leer | Auswahl |
| Badge | Text, Farbe (Labelfarbe; leer = nach dem Text), Ausrichtung | – |
| Fortschritt | Beschriftung, Wert, Maximum (100), Wert ausblenden, Text zum Wert, Farbe (leer = Akzent, ok, warn, danger – auch als Bindung) |
– |
| Container | Titel, Stil (Karte, schlicht); eigenes Raster | – |
| Tabs | Tabs mit Beschriftung; je Tab ein eigenes Raster | – |
| Dialog | Titel, Größe; wird mit der Aktion Dialog öffnen gezeigt | – |
Feld (bei Eingabe, Auswahl, Datum, Checkbox): die Spalte, aus der Formular füllen den Wert nimmt, wenn der Name des Elements anders lautet (z. B. Name due_date, Feld due date).
Kennzahl: Prozent erwartet den Wert schon in Prozent (42 → „42 %“). Vergleichen mit ist meist eine Bindung auf den Vorwert, z. B. {{query.kpis.data.hoursPrev}}; die Änderung erscheint grün, wenn sie in die gute Richtung geht (bei Kosten oder offenen Posten steigend ist schlecht wählen).
Diagramm: Das Reihen-Feld teilt die Werte nach einer zweiten Spalte auf – Säulen und Balken stehen dann nebeneinander (oder mit gestapelt übereinander), jede Reihe bekommt eine eigene Linie bzw. Fläche; Kreis und Ring nutzen es nicht. Eine Reihe hat die Akzentfarbe der App, mehrere Reihen und Kreisstücke bekommen bis zu acht feste, auch bei Farbsehschwäche unterscheidbare Farben (weitere fallen unter „Andere“), dazu immer eine Legende – beim Kreis mit Wert und Anteil. Jede Säule, jeder Punkt und jedes Stück zeigt beim Überfahren die Werte. Auswahl läuft beim Klick, mit point = {label, series, value} – z. B. Seite öffnen mit Parameter stage = {{point.label}}; auf der Zielseite liest {{url.stage}} den Wert.
CSV-Download (bei Tabelle, Liste, Diagramm; aus, bis man ihn einschaltet): ein Knopf CSV oben rechts am Element. Tabellen und Listen laden dafür alle Datensätze ihrer Abfrage (nicht nur die angezeigte Seite, in der aktuellen Sortierung), Tabellen mit ihren Spalten und Überschriften, Listen mit allen Feldern; ein Diagramm liefert, was es zeigt (eine Zeile je Beschriftung, eine Spalte je Reihe, beim Kreis Wert und Anteil). Die Datei ist UTF-8 und passt zur Sprache der Oberfläche: Komma als Trennzeichen bei Punkt als Dezimalzeichen (Englisch), sonst Semikolon und Dezimalkomma – so öffnet Excel sie direkt. Werte kommen roh (Zahlen ohne Tausenderpunkte, Datum als 2026-11-12), Text, der wie eine Formel beginnt (=, +, -, @), bekommt ein Hochkomma vorangestellt. Dieselbe Datei erzeugt die Aktion CSV exportieren – auch ohne Knopf am Element.
Kalender: Monat oder Woche, mit Blättern und Heute; mehrtägige Einträge erscheinen an jedem Tag, bei mehr als drei an einem Tag öffnet „+n weitere“ die Woche. el.<id>.from und el.<id>.to sind der sichtbare Zeitraum (JJJJ-MM-TT) – als Parameter der Abfrage lädt sie nur diesen. Auswahl läuft beim Klick auf einen Eintrag (mit item, auch el.<id>.selected), Klick auf einen Tag mit date (z. B. Formular füllen mit {"day": "{{date}}"} und einen Dialog zum Anlegen öffnen).
HTML: freies HTML für eigene Kacheln, Hinweise oder Karten. Platzhalter werden vor dem Einsetzen maskiert – ein Wert mit <b> erscheint als Text, nicht als Auszeichnung. Danach wird das HTML bereinigt: keine Skripte, keine Event-Handler (onclick …), keine javascript:-Links, keine <style>-Blöcke, Formulare oder Frames; Inline-Stile (style="…"), Links (auch mailto:, tel:) und Bilder bleiben. Links mit target="_blank" öffnen ohne Zugriff auf die App. Bilder von fremden Adressen zeigt der Browser nur, wenn die Sicherheitseinstellungen sie erlauben. Mit einer Abfrage lädt das Element seine Daten selbst: {{record.name}} ist der Datensatz (bzw. der erste), {{records}} die Liste.
Datei: Abfrage ausführen mit einer Abfrage Datei hochladen schickt jede gewählte Datei des Formulars (oder des in der Aktion gewählten Datei-Felds) einzeln an den Datensatz – mit der Schreib-Freigabe genau dieser Tabelle, nie mehr, als das Konto ohnehin darf. Größe (höchstens 50 MB je Datei) und erlaubte Dateitypen bestimmt zusätzlich die Anhang-Spalte; der Inhalt wird geprüft, nicht die Endung. Ein neuer Datensatz mit Datei: erst Datensatz anlegen, dann Datei hochladen mit {{query.<anlegen>.record.id}} als Datensatz. el.<id>.value ist die Liste der gewählten Dateien; Formular leeren leert sie.
Kanban: eine Spalte je Wert des Spalten-Felds, im Kopf Anzahl und (mit Summen-Feld) die Summe. Karten lassen sich mit Maus oder Finger in eine andere Spalte ziehen, mit der Tastatur bewegt Pfeil links/rechts die fokussierte Karte, Enter wählt sie aus. Verschieben läuft mit item (die Karte), lane (die Zielspalte) und from – typisch Abfrage ausführen mit einer Änderungs-Abfrage {"id": "{{item.id}}", "stage": "{{lane}}"} und danach Abfrage neu laden. Die Karte steht sofort in der neuen Spalte; scheitert eine Aktion, kehrt sie zurück. Reine Zahlen, Beträge und Prozente als Badge erscheinen neutral grau.
Galerie: Ist das Bild-Feld eine Anhang-Spalte, zeigt die Kachel das erste Bild als Vorschaubild; ohne eigenes Auswahl-Ereignis öffnet ein Klick das Bild groß (Esc schließt). Bilder und Dateien aus Anhang-Spalten liefert die App über ihre eigene Adresse aus (siehe fileUrl in Bindungen und Aktionen) – auch für App-Nutzer und öffentliche Apps, die die REST-API nicht verwenden dürfen.
Suchauswahl: sucht beim Tippen – die Abfrage bekommt den Text im Such-Parameter, z. B. eine Liste mit dem Filter name enthält {{params.q}} (leerer Text = alle). Für Fremdschlüssel in großen Tabellen, wo eine Auswahl zu lang würde. Pflichtfeld heißt: ein Eintrag aus der Liste, nicht nur Text. Füllt Formular füllen einen Wert ein, zeigt angezeigte Beschriftung (z. B. {{query.lead.record.client_name}}) seinen Namen; el.<id>.label ist die Beschriftung der Wahl. Mehrfachauswahl liefert eine Liste – als Parameter mit dem Typ beliebig.
Trenner und Abstand gliedern eine Seite: Ein Trenner ist eine Linie, auf Wunsch mit einer kleinen Überschrift (links, mittig oder rechts) oder senkrecht zwischen zwei Spalten. Ein Abstand ist leerer Platz, etwa damit ein Button rechts steht. Auf dem Handy, wo alle Elemente untereinander stehen, fallen Abstände und senkrechte Trenner weg; waagerechte Trenner bleiben.
Karte
Die Karte zeigt Datensätze als Punkte oder färbt Länder und Regionen nach einem Wert ein.
- Punkte: Breiten- und Längengrad-Feld (Standard
latitude/longitude, Dezimalgrad). Titel und Text je Punkt mit Platzhaltern ({{item.name}}) erscheinen beim Überfahren. Das Farb-Feld nimmt eine Labelfarbe (red, blue …),#hexoder eine Kategorie (bis zu acht, mit Legende). Nahe Punkte werden zu einer Zahl zusammengefasst; ein Klick darauf zoomt hinein, liegen sie an einem Ort, erscheint eine Auswahlliste. Ereignis Auswahl mititem. - Flächen: Das Flächen-Feld enthält einen Ländercode (ISO 3166 Alpha-2 wie
DEoder Alpha-3 wieDEU), einen Regionscode (ISO 3166-2 wieDE-BY) oder einen Ländernamen; dazu Wert-Feld und zusammenfassen (Summe, Anzahl, Mittelwert). Fünf Stufen einer Farbe, eine Legende mit kleinstem und größtem Wert und ein Tooltip mit Name und Wert. Ereignis Auswahl mitarea(code,name,value). - Ausschnitt: passt sich den Daten an (bei Flächen dem Festland, ohne Überseegebiete); Mitte (
Breite, Länge) und Zoom legen ihn fest. Ziehen verschiebt; Doppelklick, + / − und Strg + Mausrad zoomen – das Mausrad allein erst nach einem Klick in die Karte, sonst scrollt die Seite; ⤢ zeigt wieder alles. Tastatur: Pfeiltasten, + / −, 0. Auf Touch-Geräten scrollt senkrechtes Wischen die Seite, bis du auf die Karte tippst; zwei Finger zoomen. - Grundkarte: eingebaut, aus Natural Earth (gemeinfrei): Länder, Küsten und ab Zoom 5 die Regionsgrenzen – ohne externe Anfragen, auch ohne Internet. Straßen und Orte zeigt sie nicht. Ist ein Kachelserver eingetragen (Einstellungen → Sicherheit → Karten), liegen dessen Kacheln darunter; Grundkarte: outline nimmt trotzdem die eingebaute.
- Koordinaten aus Adressen (Geokodierung) sind nicht eingebaut – die Daten bringen sie mit, etwa über ein Skript oder einen Workflow mit deinem eigenen Dienst.
Werte der Elemente
- Eingaben, Auswahl, Datum, Checkbox:
el.<id>.value– z. B.{{el.search.value}}als Parameter einer Abfrage. - Formular:
el.<id>.values– Name der Eingabe (oder ihre ID) → Wert. Beim Absenden steht derselbe Inhalt alsvaluesbereit. - Tabelle und Liste:
el.<id>.selected– der zuletzt gewählte Datensatz; beim Ereignis Auswahl alsrow(Tabelle) bzw.item(Liste). - Tabs:
el.<id>.tab– die ID des offenen Tabs.
Datenelemente
Tabelle, Liste, Diagramm und Auswahl mit Abfrage laden ihre Daten selbst: Sobald sich ein Parameter ändert (zum Beispiel ein Suchfeld), fragen sie kurz danach neu ab. Spalten ohne eigene Liste zeigt die Tabelle alle Felder der Abfrage. Formate: Datum, Datum mit Uhrzeit, Zahl, Währung, Ja/Nein, Badge (der Wert als farbige Pille) und Fortschritt (0–100 als Balken). Ohne eigene Farbe bekommen gängige Zustände eine sprechende: Done, Paid, Won, Approved, Active grün, Overdue, Lost, Urgent, Blocked rot, Review, Sent, Proposal, In progress, High bernstein, Qualified, Scheduled, Medium blau, New, Open, To do, Backlog, Draft, Low grau; jeder andere Wert immer dieselbe Farbe.
Die Detailansicht zeigt einen Datensatz als beschriftete Feldliste – etwa den in einer Tabelle gewählten Datensatz oder das Ergebnis einer Abfrage Ein Datensatz (bei einer Liste den ersten Eintrag). Die Spalten ordnen sich selbst an: Auf schmalen Flächen stehen die Felder untereinander. Zusätzlich zu den Formaten der Tabelle gibt es hier Markdown (für lange Texte, über die ganze Breite). Leere Werte erscheinen als „–“ oder mit Leere Felder ausblenden gar nicht.