Handbuch · 8

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 …), #hex oder 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 mit item.
  • Flächen: Das Flächen-Feld enthält einen Ländercode (ISO 3166 Alpha-2 wie DE oder Alpha-3 wie DEU), einen Regionscode (ISO 3166-2 wie DE-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 mit area (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 als values bereit.
  • Tabelle und Liste: el.<id>.selected – der zuletzt gewählte Datensatz; beim Ereignis Auswahl als row (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.