Zum Hauptinhalt springen

Push button

Das Steuerelement Push button bildet einen einfachen Druckkopf nach. In der Interaktion werden die Ereignisse onTrue, onFalse und immer auch onChange geliefert.

CSS Klassen​

  • dashboardRadioControl: das äußere HTML Element (DIV) zur Repräsentation des Bausteins in der Vorlage oder dem Steuerelement erhält diese CSS Klasse.
    • controlEnabled: diese CSS Klasse wird zusätzlich gesetzt, wenn der Parameter Status den Wert true liefert - dies wird im Folgenden als enabled bezeichnet.
    • controlDisabled: analog wenn der Parameter Status false liefert - kurz als disabled bezeichnet. Man beachte, dass der Wert von Status auch weder false noch true liefern kann (etwa weil Status keinem Parameter zugeordnet wurde). In diesem Fall ist der Baustein weder enabled noch disabled.
    • controlActiveTrue: wie beim Parameter Status, nur wird hier der Parameter Active auf true verglichen - die entsprechende Bezeichnung ist dann natürlich active.
    • controlActiveFalse: inactive für einen Wert false des Parameters Active.
  • dashboardRadioControlInput: in diesem HTML Element (DIV) wird der Umschaltknopf (CSS border-radius:50%) visualisiert.
    • on: falls der Wert des Parameters Source truthy ist (JavaScript !!).
    • off: falls der Wert des Parameters Source falsy ist (JavaScript !).

Ist der Baustein disabled, so reagiert er nicht auf Interaktionen.

CSS Variablen​

  • --dashboard-radio-control-background, Voreinstellung #ffffff: der Hintergrund (CSS background) des ganzen Bausteins.
  • --dashboard-radio-control-foreground, Voreinstellung #000000: der Hintergrund (CSS background) des Umschaltknopfs, wenn der Parameter Source einen truthy (JavaScript !!) Wert liefert.
  • --radio-background: der Hintergrund (CSS background) des ganzen Bausteins.
  • --radio-foreground: der Hintergrund (CSS background) des Umschaltknopfs, wenn der Parameter Source einen truthy (JavaScript !!) Wert liefert.

Besondere Hinweise​

Der Umschaltknopf erscheint (in der konfigurierten Farbe) sobald der Wert des Parameters Source im Sinne von JavaScript truthy ist - e.g. true, 12, [], , ... Bei Veränderungen wird aber immer true oder false in den Parameter zurückgeschrieben - sofern dieser verbunden wurde. Das kann zu Fehlermeldungen führen, wenn der Parameter respektive die zugehörige Variable kein einfacher Wahrheitswert ist.