Table

​

Overview

The Table component is available only for Web, built to deliver a consistent design through FlowX.AI’s theming framework. It closely mirrors the Collection component functionality, offering dynamic data handling and flexible row/column configurations.

​

Table elements

1. Table Header (th)
   Displays column labels, typically one th element per column.
2. Rows (tr)
   Each row represents a single data entry from the source array. Rows automatically repeat based on your data size.
3. Cells
   Cells hold data points within each row. You can place multiple UI elements (text, image, link, buttons) inside a cell.
4. Actions Column
   If you enable row deletion or editing, an actions column is automatically created to handle row-level features (delete icon, edit icon, etc.).

​

Configuring the table

When building a Table, you’ll primarily interact with:

• Generic Settings (source key, columns, table body, expressions, styling)
• Cell-Specific Settings (sorting, filtering, editing, validators)

​

Table generic settings

The following generic settings are found in the Generic tab and apply to all platforms (Web, iOS, and Android):

• Source key
• Columns
• Table body
• Expressions
• Table Styling

​

Source key

• Specify an array of objects (e.g., application.users), enabling dynamic row creation based on your data structure.
• Similar to the Collection component.

​

Columns

• Customize the Table’s columns: add, delete, rename, or reorder.
• Each column automatically includes a corresponding th (header cell) and td (body cell).

​

Table body

• Default Sorting: Sortable option must be enabled for the selected column for default sorting to work.
  • Column: Select the desired column.
  • Direction: Set the sort direction (Ascending or Descending).
• Pagination: Control how data is displayed by configuring pagination or enabling scrolling.
  • Page Size: Set the maximum number of entries displayed per page.
• Scrollable: Disable pagination to enable continuous scrolling through data.
• Deletable Rows: Enable row deletion.

​

Hide condition

• Optionally hide the entire Table based on a JavaScript expression including the data key from another component.
• Useful for conditional flows (e.g., only show the Table if certain conditions are met).

Demonstration:

---

​

Feature highlights

​

Default sorting

• Enable default sorting in table body settings.
• Select the desired column and sort direction (ascending by default).

​

Pagination & scrolling

Define how many rows appear on each page using Pagination feature.

• Scrolling: Disable pagination to allow continuous scrolling.

​

Editable rows

Enable row editing in cell-level → column settings.

• Editing can be triggered by double-click or the dedicated Edit button icon.

• Edits are validated and saved row-by-row.

​

Deletable rows

Toggle Deletable in Table settings to enable row deletion.

​

Filters

Mark columns as filterable to enable filtering icons.

• Filter type automatically matches the column data type (string, number, date, boolean, or currency).

​

Table styling

​

Sizing

• Fit Width: By default, the Table stretches to occupy available width.
• Fit Height: Grows automatically based on content height.

​

Cell styling

Layout Options:

• Direction: Horizontal (default).
• Justify: Space-around (evenly spaces elements within each cell).
• Align: Start (left-aligned).
• Wrap: Enables text wrapping.
• Gap: 8px spacing between cell elements.

Column Style Options:

• Width Fit Options:
  • Fill: Fills available container space.
  • Fixed: Keeps a fixed column width.
  • Auto: Adjusts column width to fit content.

• User Resizable Columns: Adjust column width by dragging the column edges in the header, enhancing customization.

This Table component enhances flexibility and offers a cohesive design, integrated with FlowX.AI’s theming framework for a consistent, web-optimized user experience.

​

Table UI action

Append a saveData action to the table and configure the UI action’s custom keys with the same key used as source for the table, in order for the backend to take into consideration the updated array. See User Task configuration section for more details.

​

Actions in table cells

When configuring actions within a Table component, each action is bound to a unique table item key, ensuring that interactions within each cell are tracked and recorded precisely. The key allows the action to target specific rows and store results or updates effectively.

• Table Item Save Key:
  • This key is essential for identifying the exact cell or row where an action should be executed and saved.
  • It ensures that data within each cell remains distinct and correctly mapped to each table entry.
• Custom Key for Data Saving:
  • Important: To properly send the data from a selected cell/row to the backend, you must configure both a Custom Key (in your SaveData action) and a Table Item Save Key (in your column/cell configuration) using the same value.
  • Having only a Table Item Save Key is not sufficient to propagate the updated information. The matching Custom Key in the SaveData action tells the system which row/cell data to capture and transmit.

• Supported Action Types - Available actions include:
  • Action: Initiates predefined actions within the cell.
  • Start Process Inherit: Enables workflows inherited from process configurations to be triggered.
  • Upload: Allows file or data uploads directly within a table cell.
  • External: Used to create an action that will open a link in a new tab.

​

User Task configuration

When configuring a screen in User Task containing table, you must configure the following node actions:

​

FAQs