Schaltfläche

Ca. 4 Min. Lesezeit

TwButton · Kategorie: Schaltflächen

Touch-Panels

Die Einstellungen der Schaltfläche für Touch-Panels sind auf der Seite Touch-Panels beschrieben:

• Sperrgrund: Text, der beim Tippen auf eine gesperrte Schaltfläche erscheint.
• Zweistufig ausführen und Zeitfenster zweiter Druck (s): Der Wert wird erst beim zweiten Drücken geschrieben; siehe Zweistufig ausführen.
• Badge und Badge-Klasse: eine Zahl oben rechts, z. B. die Anzahl aktiver Alarme; siehe Schaltflächen-Badge.
• Mit Bestätigung erforderlich trägt der Bestätigungsdialog die Beschriftung der Schaltfläche; siehe Bestätigung.
• Code in onMouseDown und onMouseUp läuft auch auf Touchscreens; siehe Ereigniscode bei Touch-Bedienung.

Einstellungen

Diese Einstellungen finden Sie bei ausgewähltem Widget rechts im Eigenschaftenbereich. Der Standardwert ist der Wert, den das Widget beim ersten Einfügen in eine Seite hat.

Wert / Schreiben

Einstellung	Typ	Standardwert	Beschreibung
Prozesswert processValue	Wert (mit Typauswahl)	true	Basis-Lese-/Schreibwert. Wenn die Zustandsquelle Prozesswert ist, wird der visuelle Status aus diesem Wert berechnet.
Aktionsmodus actionMode	Auswahl	write	Schreiben: schreibt nur den Prozesswert, Link: löst nur die Link-Aktion aus, Schreiben und Link: schreibt zuerst und löst dann den Link aus. Optionen: write Schreiben, link Link, writeAndLink Schreiben und Link

Verhalten

Einstellung	Typ	Standardwert	Beschreibung
Schreibgeschützt readOnly	Kontrollkästchen	Ein	Wenn aktiv, kann der Benutzer den Wert zur Laufzeit nicht ändern.
Zweistufig ausführen twoStepApply	Kontrollkästchen	Aus	Bei einer Schreibaktion macht der erste Druck die Schaltfläche bereit (pulsierender Rahmen und „Zum Ausführen erneut drücken“ als Beschriftung); Schreiben, Klick-Code und Link laufen nur bei einem zweiten Druck innerhalb des Zeitfensters. Die Bereitschaft endet ohne Schreiben, wenn das Zeitfenster abläuft, woanders gedrückt wird, das Fenster den Fokus verliert oder die Seite verborgen wird oder wechselt. Ist auch Bestätigung erforderlich aktiv, öffnet sich nach dem zweiten Druck weiterhin der Bestätigungsdialog. Ohne Wirkung bei reinen Link-Schaltflächen oder ohne gebundenen Wert-Tag. Der Ereigniscode für Drücken/Loslassen (onMouseDown/onMouseUp) wird von dieser Option nicht zurückgehalten und läuft auch beim ersten Drücken.
Sperrgrund lockReason	Text	—	Optional. Solange das Steuerelement zur Laufzeit gesperrt ist (Schreibgeschützt an ein Tag gebunden, das wahr ist, oder Benutzer ohne Schreibrecht), zeigt ein Tippen diesen Text kurz anstelle der Berechtigungsmeldung an; er erscheint auch als Tooltip. Beispiel: „Verriegelung: Tür offen“. Ein Sprachschlüssel wird übersetzt. Leer lässt das Verhalten unverändert.
Bestätigung erforderlich needsConfirmation	Kontrollkästchen	Aus	Fragt vor dem Schreiben des Werts in den Tag nach einer Bestätigung.
Zeitfenster zweiter Druck (s) twoStepSeconds	Zahl (1–10)	3	Zeit in Sekunden für den zweiten Druck bei aktivem Zweistufig ausführen (1 bis 10, Standard 3).

Beschriftungen / Symbole

Einstellung	Typ	Standardwert	Beschreibung
Symbol icon	Symbol	—	Automatisch: bevorzugt das Bild (IconSrc), sonst das CSS-Klassensymbol. CSS-Klasse: nur Klassensymbol. Bild: nur IconSrc (fällt auf das Klassensymbol zurück, wenn es leer ist).
Symbolposition iconPos	Auswahl	left	Das Symbol steht immer vor dem Text. Optionen: left Links, right Rechts, top Oben, bottom Unten
Hinweis hint	Text	—	Tooltip-Text, der zur Laufzeit angezeigt wird, wenn der Mauszeiger auf dem Widget verweilt.
Badge badge	Text	—	Kleine Zahl in der oberen rechten Ecke, meist an einen Tag gebunden, z. B. den System-Tag __activeAlarmCount. Leer oder 0 ausgeblendet; Zahlen über 99 als 99+; Text mit höchstens 4 Zeichen.

Darstellung

Einstellung	Typ	Standardwert	Beschreibung
Stilmodus stylingMode	Auswahl	outlined	Gefüllt füllt die Schaltfläche mit Farbe, Umrandet zeigt nur einen Rahmen (Standard), Text zeigt weder Rahmen noch Hintergrund. Optionen: contained Gefüllt, outlined Umrandet, text Text
Typ type	Auswahl	normal	Schaltflächenfarbe aus dem Theme: Normal ist neutral, Standard nutzt die Akzentfarbe, Erfolg ist grün und Gefahr rot. Optionen: normal Normal, success Erfolg, default Standard, danger Gefahr
Schaltflächenklasse buttonClass	CSS-Klassen	—	CSS-Klassen, die dem Schaltflächenelement hinzugefügt werden.
Badge-Klasse badgeClass	CSS-Klassen	—	Zusätzliche CSS-Klassen des Badges, z. B. bg-orange-500 für eine andere Farbe.

Weitere Einstellungen

Einstellung	Typ	Standardwert	Beschreibung
Enable Flashing enableFlashing	Kontrollkästchen	Aus	Lässt das Widget blinken (ein Transparenzimpuls pro Sekunde). Wird meist an eine Alarmbedingung gebunden.
Log Button logButton	Kontrollkästchen	Aus	Zeigt zur Laufzeit beim Überfahren des Widgets ein Diagrammsymbol; ein Klick fügt die an das Widget gebundenen Tags der Log-Tag-Liste hinzu.

Bindungen

Im Abschnitt Bindungen (Regeln) des Eigenschaftenbereichs kann ein Tag mit einer Direct-Bindung an die folgenden Eigenschaften dieses Widgets gebunden werden. Die Bindungstypen (Direct, IntRange, FloatRange, Boolean, Bit) sind für alle Widgets gleich; sie werden auf der Seite Widget-Referenz beschrieben.

title, visible, authorization, x, y, width, height, rotation, class, foregroundColor, backgroundColor, borderColor, borderStyle, borderWidth, borderRadius, borderTopLeftRadius, borderTopRightRadius, enableFlashing, logButton, onClick, onMouseDown, onMouseUp, to.type, lockReason, readOnly, needsConfirmation, twoStepApply, twoStepSeconds, processValue, buttonClass, badge, badgeClass, hint, icon, iconPos, stylingMode, actionMode

Gemeinsame Abschnitte

Bei ausgewähltem Widget zeigt der Eigenschaftenbereich außerdem diese gemeinsamen Abschnitte: Allgemein, Layout, Aussehen, Navigation (Ziel), Ereignisse, Bindungen (Regeln). Diese Abschnitte werden auf der Seite Seiteneditor beschrieben.