Tab Control¶
This page describes how to set up and configure the Tab Control component.
A Tab Control is a container of displays selected by a tab menu. A tab can hold a single component or a Layout panel with multiple components.
The following example shows a Tab Control with five tabs. The first Tab, Trade Performance, is selected and visible.

Set Up a Tab Control¶
To set up a Tab Control component, click-and-drag the component into the workspace and configure the following:
- Define the number of tabs you require.
- Within each tab element, add a single component, layout panel, or flex panel for multiple components.
Refer to Tab Control properties described in the next section for details on additional properties.
Tab Control Properties¶
The following sections provides details on how to configure the properties of the Tab Control component.
Basics¶
Open the Basics properties on the right and configure the property described in the following table.

| Field | Description |
|---|---|
| Name | Enter a name for the component. |
View State¶
Configure the properties described in the following table.

| Field | Description |
|---|---|
| Selected Tab | The tab that is visible when the dashboard opens. Tip! To link tabs in two separate Tab Controls (so that selecting Tab 1 of Tab Control 1 opens Tab 1 of Tab Control 2), create a view state parameter and assign it to Selected Tab of both Tab Controls. ![]() |
| Unload Inactive Tabs | When enabled, the Tab Control removes the content of a tab when you switch to another tab. |
| Expand When Creating Pdf | When enabled, the Tab Control expands its tabs when you export the dashboard to PDF. |
| Set View State on Tab Change | Expand this section to assign a value to a view state parameter when you switch tabs, in addition to linking tabs across components. For example, use it to reset a default value on tab switch.![]() |
Tabs¶
Configure the properties described in the following table.

| Field | Description |
|---|---|
| Name | Name displayed in tab. |
| Tooltip | Description of tab on mouse rollover. |
| Icon | The Font Awesome icon to display on the tab. Click the field to open the icon selector and choose an icon. |
| Icon Colour | The color of the tab icon. |
| Icon Size | The size of the tab icon. |
| Hide | A Tab can be hidden by checking this checkbox. Hiding a Tab does not remove it, it only disables the ability to click on it. Navigation to the hidden tab content can be achieved using a Button. |
| Hide in Pdf | When checked, the tab is hidden when the dashboard is exported to PDF. |
Actions¶
Tab Control actions run when the component loads or when the user switches tabs. For the action types and how to add an action, see Actions.

| Field | Description |
|---|---|
| Trigger Action | Sets the event that runs the action. Options: On Load (when the Tab Control loads); On Tab Switch (when the user switches to a different tab). |
| Run Actions Asynchronously | See Action execution for details. |
Style¶
Refer to Style for common settings.

