Updated: February 7, 2023

Data Table

FUIDataTable

Intro

A data table is a range of labeled columns and rows used to present numbers, text, or even images. Generally, data tables are a grid layout of columns and rows.

The horizontal scrollable data table with a sticky header and column is available in both compact and regular screen sizes. Alternatively, the data table will be converted to a list report by default in compact width if horizontal scrolling is not available.

Example of data tables on iPhone (left) and iPad (right)
Example of data tables on iPhone (left) and iPad (right)

 

Usage

Do

Use data tables when users need to compare multiple attributes across items in a large data set.

Use the data table in compact screen sizes with horizontal scrolling and sticky headers.

Don't

Don’t use data tables in preview views.

Don’t use data tables when users don’t need to compare multiple attributes across the items.

Anatomy

A. Header Row

A header row is always at the top of the data table. The row contains key data label of each column and always sticks to the top during scrolling.

B. Rows of Data

Each row represents one instance of data. Each column inside a row represents each attribute of the instance. The leftmost column can be persistent and stick to the left of the screen.

C. Persistent Column (Optional)

The first column can be set to be persistent which allows the column to stick to the left during scrolling.

Anatomy of the data table on iPad
Anatomy of the data table on iPad

 

Behavior and Interaction

Bulk Actions

The data table allows multi-selection. The user can choose to take further actions with the selected items.

Showing a toolbar with further actions after selecting a few rows in a data table
Showing a toolbar with further actions after selecting a few rows in a data table

 

Add a Data Row

The “+” button, which can appear on the navigation bar or in an inline cell button, allows users to add a new data row to the current data table.

The added data will appear at the location following the current order direction rules. For example, if the table is ordered by timestamp, the added row will appear as the top row.

The screen will scroll to the location where the added row appears with the highlight background color. The highlight background color then fades away.

Showing the most recently added row at the top of the table
Showing the most recently added row at the top of the table

 

Edit a Data Row

An edit action can either be triggered after a drill-down to see object details, or it can be triggered after tapping the “Edit” button within a row.

Showing an Edit modal after triggering the edit mode from the data table view
Showing an Edit modal after triggering the edit mode from the data table view

 

Edit Data In-line

An in-line edit mode can be triggered after tapping the “Edit” button in the navigation bar. It allows the user to edit multiple data cells in-line without drilling down to the object detail pages.

In the edit mode, the user can tap on any available data table cell to edit. An active data table cell has a highlighted stroke and text background. Once the user is done editing, they can tap on the “Done” button in the navigation bar to save and exit the in-line edit mode.

Showing how to enter and exit the in-line editing mode
Showing how to enter and exit the in-line editing mode

If there is an invalid entry, the cell is highlighted in red and a banner with an error message pops up. If the user deselects the cell, the error is still visible with a red underline and a banner with an error message is displayed.

Showing How to Show In-line Error Message
Showing How to Show In-line Error Message

Currently supported data types include text, duration, time, date, and list picker.

Examples of text, duration, time, date, and list picker data table cells from left to right
Examples of text, duration, time, date, and list picker data table cells from left to right

 

Adaptive Design

In compact width layout, the data table is converted to a list report by default. If this is not wanted, app developer can make changes to allow displaying a data table in a compact width layout as well.

If the data table is set to show in the compact layout, a horizontal scroll will be available.

Example of a data table the has been converted to a list picker
Example of a data table the has been converted to a list picker

 

Resources

Related Components: Table View, List Report, Filter Feedback Bar

Development: Data Table