MENU
    Radial Gauges
    • 17 Apr 2024
    • 2 Minutes to read
    • Contributors

    Radial Gauges


    Article summary

    Visually represent your values on a radial scale and make it clear for the operator when values approach limits.

    Purpose

    The Radial gauge custom widgets Display numerical values and ranges on a radial scale. Radial Gauge is a multi-purpose data visualisation control that displays numerical values on a Semi-Circular scale. It has a rich set of features such as ranges, pointers, and colours that are fully customizable and extendable. Use it to create speedometers, temperature monitors, dashboards, activity gauges, compasses, and more.

    Radial Gauges are designed to make a way to display numerical values and ranges on a radial scale. Radial gauge can have a minimum value (starting value to the left) and maximum value (ending value to the right) set. When you set up the Value prop, this will determine the pointer position compared to the Max and Min props.

    Setup

    Radial Gauges are designed to make a way to display numerical values and ranges on a radial scale. Radial gauge can have a minimum value (starting value to the left) and maximum value (ending value to the right) set. When you set up the Value prop, this will determine the pointer position compared to the Max and Min props.

    Gauge SVG:

    this segmented gauge will have 3 colour background with ranges 0-33 (Red) , 33-67 (Yellow), 67-100 (Green).

    Properties
    Value - Value the needle should point to.
    Min Value - Value to be used as Minimum Value
    Max Value - Value to be used as Maximum Value
    Title - Text to be displayed as Gauge Title

    Events
    Error - Fires when value is outside Min Value and Max Value range
    Screenshot 2023-03-23 at 12.00.21.png

    Gauge with Region

    If region lower limit and upper limits are provided, it can be highlighted in a different colour. The event will return true or false based on whether the value falls within the inner region or not. For eg., 50-75 is an inner region highlighted with a different Custom colour.

    Properties
    Value - Value the needle should point to.
    Min Value - Value to be used as Minimum Value
    Max Value - Value to be used as Maximum Value
    Title - Text to be displayed as Gauge Title
    Lower Limit - Value for Lower Limit of Inner Region
    Upper Limit - Value for Upper Limit of Inner Region
    Background - Color for Gauge Background
    Region - Color for Inner Region Background

    Events
    Error - Fires when value is outside Min Value and Max Value range
    Status - Returns true when the value falls within the inner region, false otherwise
    Screenshot 2023-03-23 at 12.00.32.png

    Gauge with Background Color

    Gauge with background can be used to set custom colour background to the gauge.

    Value - Value the needle should point to.
    Min Value - Value to be used as Minimum Value
    Max Value - Value to be used as Maximum Value
    Title - Text to be displayed as Gauge Title
    Background - Color for Gauge Background

    Events
    Error - Fires when value is outside Min Value and Max Value range
    Screenshot 2023-03-23 at 12.00.38.png

    How it works

    You should configure the properties and events of your custom widgets to take as input a static value, a variable or a table record value used in your application.
    Screenshot 2023-03-14 at 14.49.54.png

    You can configure the properties of your custom widget in the Widget pane of your app editor. In this example, the custom widgets properties are configured to take the variables Value, Minimum and Maximum as inputs. However, these can be also a static value or a table record value.*

    Further Reading


    Was this article helpful?