Flova Docs

Widgets

Choose, add, connect, and configure widgets in Studio.

Widgets are the building blocks of a dashboard. Some display data, some accept input, and some organize other widgets. Add one from Widgets, place it on the canvas, then configure content, data, appearance, and behavior in the Inspector.

CategoryWidgetsUse it for
LayoutArea, Stack, Grid, RepeaterGrouping content and repeatable structure.
ContentText, Icon, Image, HTML WidgetLabels, images, icons, and custom presentation.
DataGauge, Chart, Table, Alarm listCurrent values, history, query results, and alarms.
InputToggle, Slider, Color, Countdown, Select, Number, Duration, Text Input, ButtonUser input and device commands.
NavigationNavigationMoving between pages or opening a navigation surface.
OverlaySheet, DrawerContent above the current page.
WidgetGood starting pointCommon requirement
GaugeCurrent numeric or boolean valueA compatible binding and useful range.
ChartTelemetry over a time rangeOne or more series and a supported source.
TableQuery resultsA saved FlovaQL query and column configuration.
Alarm listDevice alarms and eventsScope and display options.
TextTitle, label, or descriptionText content and optional binding.
ImageProduct or device imageryAn uploaded asset or supported URL.

Match input widgets to the datastream. Use Toggle for boolean values, Slider or Number Control for numbers, Select for enums, Color for RGB commands, Duration for seconds, Text Input for text, and Button when the action matters more than a persistent value.

Read and write access are separate. A widget may display a read-only value while remaining unable to send a command. Check Console access mode and the Studio binding.

Custom HTML

The HTML Widget accepts sandboxed HTML, CSS, and JavaScript. Parent Studio styles do not cascade into it, so keep required styles inside the widget.

Connected values are exposed through window.FlovaBridge. Binding slots are indexed as input_0 through input_7.

<script>
  const bridge = window.FlovaBridge;
  bridge.setCallbacks({
    onValueUpdated: (item) => {
      document.querySelector("#value").textContent = String(item?.value ?? "");
    },
  });
  bridge.getValue(0).then((item) => {
    document.querySelector("#value").textContent = String(item?.value ?? "");
  });
</script>

The widget cannot use network requests, storage, forms, external scripts, arbitrary stylesheets, or frames. Use onError to surface rejected bridge calls. getValues(), getTheme(), and onThemeUpdated are available when the widget needs all inputs or theme updates.

Keep custom HTML self-contained. Test it in preview with the intended binding, then check the published dashboard.

Add a widget

  1. Search Widgets by name or category.
  2. Drag a widget onto the page.
  3. Select it on the canvas or in Layers.
  4. Give it a useful layer name.
  5. Configure content and data before detailed styling.
  6. Test preview and every breakpoint.