Button Facelet

The Button Facelet renders an interactive push or toggle button with customizable shape, text and colors.

Configuration

  • Position
    X, Y position of the top-left corner in screen coordinates [mil].

  • Size
    Width and height of the button in [mil].

  • Button Shape

    Shape Description

    Default

    Default button shape.

    Round

    Round button.

    Rect

    Rectangular button.

    Oval

    Oval button.

  • Button Mode

    Mode Description

    Push

    Momentary push button. Sends the on-output on press and the off-output on release.

    Toggle

    Toggle button. Alternates between on and off state on each tap.

  • Tap Length
    Duration of the tap event in milliseconds.

  • Vibrate on Tap
    Enable haptic feedback (vibration) on button tap.

  • Input
    Input source expression for the button state.

  • Output On
    Provider output expression triggered when the button is pressed or toggled on.

  • Output Off
    Provider output expression triggered when the button is released or toggled off.

  • Text
    Text to display on the button. Supports data binding expressions.

  • Font
    Select the font family for the button text.

  • Text Size
    Text size in [mil]. Set to 0 for automatic sizing.

  • Color On
    Button color in the on/pressed state.

  • Color Off
    Button color in the off/released state.

  • Visibility
    A condition expression. The Facelet is displayed if this evaluates to 1.

  • Display Mode

    Mode Description

    Normal

    This Facelet is only displayed in interactive (normal) mode.

    Ambient

    This Facelet is only displayed in ambient mode.

    Always

    This Facelet is displayed in both interactive and ambient mode.

  • Ambient Color
    Select a color for the ambient mode.
    0 uses the common ambient color of the face settings.