For the complete documentation index, see llms.txt. This page is also available as Markdown.

Using the Components Panel

The Components panel is where you add new elements to your ROI Model

It provides access to the Inputs, Outputs, layout elements and presentation components available in ROI Studio.


Opening the Components Panel

Select Components from the ROI Studio toolbar.

The Components panel opens and displays the elements that can be added to your model.

Components are organised into categories to make it easier to find the type of element you need.


Inputs

Input components allow users to provide or select values that can be used by calculations within the ROI Model.

Available Input components include:

  • Range Slider Input

  • Numerical Input

  • Dial Input

  • Radio Button Input

  • Dropdown Input

  • Multi Select Input

  • Toggle Yes / No

Choose the Input type based on how you want the user to interact with the value.

For detailed guidance, see Adding & Configuring Inputs and the individual Input component articles.


Outputs

Output components display calculated results or visualise calculated information.

Available Output components include:

  • Std Formula Output

  • Card Formula Output

  • Gauge Formula Output

  • Table Formula Output

  • Chart

Standard, Card and Gauge Outputs display individual calculated results using different presentation styles.

Tables and Charts allow calculated information to be presented in more structured or visual formats.

For detailed guidance, see Adding & Configuring Outputs and the individual Output component articles.


Layout & Presentation Components

The Components panel also contains elements that help organise and present your ROI Model.

These include:

  • Input Header

  • Output Header

  • Columns

  • Accordion

  • Micro Tabs

  • Dynamic Value Text

These components do not all behave like calculation Inputs or Outputs.

Instead, they can be used to create structure, group related content and improve how information is communicated within the model.


Adding a Component

To add a component:

  1. Open Components.

  2. Find the component you want to add.

  3. Select the component.

  4. Configure its available settings.

  5. Select Save.

The new element is then added to the ROI Model.

The exact configuration options depend on the component selected.


Configuring a Component

Different components provide different settings, but commonly available configuration can include:

  • Display Label

  • Display Detail

  • initial or default values

  • number formatting

  • colours

  • icons

  • tooltips

  • formulas

  • Visibility Conditions

Some components also provide specialised settings unique to that component type.

For example:

  • choice Inputs contain configurable options;

  • Formula Outputs contain calculations;

  • Tables contain rows and columns;

  • Charts contain data sources;

  • layout components contain other elements.

See Working with Components & the Canvas for more information.


Choosing the Right Component

Start by considering what role the element needs to perform.

Use an Input when the user needs to provide or select a value.

Use an Output when the model needs to calculate and display a result.

Use a Table when multiple related values need to be presented in a structured grid.

Use a Chart when calculated values are better communicated visually.

Use layout and presentation components when you need to organise or explain the model rather than create another calculation.


After Adding Components

Once components have been added, you can continue to manage the model using ROI Studio.

Depending on the component, you can:

  • edit its configuration;

  • copy it;

  • delete it;

  • change its component type where supported;

  • reorder it using the Navigator;

  • assign it to a page in a multi-page Calculator;

  • apply conditional visibility.

This allows the model to evolve as you build and refine the business case.


Last updated