Skip to main content

Dynamic Control

The Dynamic Control Widget is used to control the behaviour and visibility of other widgets within a report using Variables. It works by assigning a Variable Name and Variable Value, which interact with supported widgets to trigger dynamic actions and changes.

Dynamic Controls can be used to:

  • Switch between Panel layers.
  • Make other widgets visible or hidden.
  • Toggle widget states.
  • Create dynamic and interactive report experiences for end users.
caution

There is no autosave feature for Reports. Click Save regularly while working in the Report Workspace.

Dynamic Control Widget Configuration​

After inserting and selecting the Dynamic Control widget, its configuration options are displayed in the right-side Settings Panel under the Dynamic Control tab.

  1. Variable Name — Set the variable name for this control. This must exactly match the variable name used in the target widget(s) you want to control.
  2. Variable Value — Set the variable value for this control. This must match the value configured in the target widget(s).
  3. Toggle on Click — When enabled, the Dynamic Control toggles between active and non-active states when clicked.
  4. Variant — Choose the display style for the control widget:
    • Text — Displays as a simple text button without borders, with a background highlight on hover.
    • Outlined — Displays with an outlined border, with a background highlight on hover.
    • Contained — Displays as a filled button with a solid background colour.
    • Icon — Displays as an icon-only button without text.
  5. Font Styles — Customise the font appearance for the control label, including Font Family, Font Size, and Font Weight.
  6. Non-active Config — Configure the appearance of the control when it is not active:
    • Label — Custom label for the non-active state.
    • Color — Background or display colour for the non-active state.
    • Default Icon — Icon for the non-active state.
  7. Active Config — When enabled, separate styling options become available for the active state:
    • Label — Custom label for the active state.
    • Color — Background or display colour for the active state.
    • Default Icon — Icon for the active state.