Skip to main content
Version: 25.2 (main)

Dashboard Widget

A dashboard widget is an adaptive container that groups related elements and information on a Dashboard Page.

Dashboard widgets can contain a wide variety of HELIO Element Types, including Gauge, Magic Input or Magic Output.


Common Properties

Container

Icon

This icon will be displayed next to the element's label on pages that support it, like the Dashboard Page. An Element can make use of the icon to:

  • Provide more context to add meaning
  • Improve recognition and discoverability, especially on larger pages

Label

Provides context and information to operators, guiding them and helping them understand the value of this particular element. A good label instills confidence in operators when making adjustments.

Description

Will be displayed underneath the element. This description provides additional guidance or instructions for operators manipulating the element. It expands on the label by offering supporting details and clarifying what the element represents or how it behaves. It provides an opportunity to offer more detailed context regarding the potential impact of changes or further instructions on the desired input format.
Widget with Title
Widget with Icon
Display Condition

Condition

Determines whether an element or page should be visible or hidden to the current user. The condition can be set to different types of Dynamic Property – as long as the the type returns true or false you're good to go.

Specific Properties

Main Action

Button that will be displayed in the upper right corner of the widget. By pressing it, users can execute an action.

Label

Label that will be used for the action button.

Icon

Icon that will be displayed on the action button.

Example Widget with Main Action and Icon

On click

Action that gets executed when clicking the button. Use it to:

Is disabled

Disable the action by setting this boolean property to true. The action will never execute while it is disabled.

Custom Layout

Declare a custom layout for this widget. It will be used whenever possible, otherwise HELIO will use a default layout as a fallback. Be aware that this feature is still in Beta, so please use it with caution!

This custom layout has the highest priority. If there is not enough space or the layout does not match the number of elements, the best-fitting alterative layout will be automatically applied.


Elements that You Can Add to Widgets