Table Features

Intro

The SAP Fiori elements templates support the features and settings for a table detailed below.

For design information see the table guidelines, starting with Table Overview, and the links within this article.

Feature Availability

[internal_only]

Table Settings

Availability

Column Header Labels
You set these.
Tooltips on Column Header Labels
Available for exceptional use cases with SAP Fiori elements for OData V4
Clear All

With SAP Fiori elements for OData V2, when the selection of multiple rows is enabled, the clear all checkbox is displayed by default for:

  • Grid tables, analytical tables and tree tables in both list reports and object pages
  • Responsive tables in a list report

With SAP Fiori elements for OData V4, when the selection of multiple rows is enabled, the clear all checkbox is displayed, for all tables, except a responsive table in an object page with anchor bar mode.

You can change the default.

Select All

With SAP Fiori elements for OData V2, when the selection of multiple rows is enabled for a responsive table, the select all checkbox is displayed by default in an object page.

With SAP Fiori elements for OData V4, when the selection of multiple rows is enabled for a responsive table, the select all checkbox is displayed by default in an object page with anchor bar mode.

You can change the default.

Sticky Column Header Behavior
Default, you can turn it off.
Column Width
The default width depends on the column contents. You can change it.
Column Importance

In a responsive table, by default, all columns have an importance of none,

except

for list report columns for key fields. These have high importance.

You can change the level of importance.

Labels for Multiple Fields in a Column
Available in responsive tables with SAP Fiori elements for OData V4
Ascending Sort Order on a Column
Default, you can change it.
Grouping
Available in responsive and analytical tables, not in grid tables
Grouped Totals in Analytical Tables
For now, an asterisk (*) is displayed instead of a figure for grouped totals of items with different units of measure in the same group.
Number of Table Rows Displayed at Once
Work with the development team to find the best compromise between optimal user experience and optimal technical performance.
No Data Found Text
Default, replace the generic placeholder text with text that’s meaningful to the user.
Message Strip above the Table

You can display a custom message above the table in the:

  • List report, object page, and analytical page with SAP Fiori elements for OData V2
  • List report with SAP Fiori elements for OData V4

In the object page, by default, a message strip is displayed when there are errors in the table.

When there are multiple messages, the one with the highest severity is displayed.

List Report and Analytical Page Only

Availability

Number of Table Levels Expanded at Initial Load
Default, you can change the number for the tree table and analytical table.

Object Page Only

Availability

Message Strip for Rows with Errors
Default
Rows Displayed in a Grid Table

Depends on the table height, which adjusts to the available onscreen space for an object page with:

  • Anchor bar navigation and a single section that contains only a grid table
  • Tab bar navigation and a current tab that contains only a grid table

[/internal_only]

[external_only]

Table Settings

Availability

Column Heading Labels
You set these.
Tooltips on Column Header Labels
Available for exceptional use cases with SAP Fiori elements for OData V4
Clear All

With SAP Fiori elements for OData V2, when the selection of multiple rows is enabled, the clear all checkbox is displayed by default for:

  • Grid tables, analytical tables and tree tables in both list reports and object pages
  • Responsive tables in a list report

With SAP Fiori elements for OData V4, when the selection of multiple rows is enabled, the clear all checkbox is displayed, for all tables, except a responsive table in an object page with anchor bar mode.

You can change the default.

Select All

With SAP Fiori elements for OData V2, when the selection of multiple rows is enabled for a responsive table, the select all checkbox is displayed by default in an object page.

With SAP Fiori elements for OData V4, when the selection of multiple rows is enabled for a responsive table, the select all checkbox is displayed by default in an object page with anchor bar mode.

You can change the default.

Sticky Column Header Behavior
Default, you can turn it off.
Column Width
The default width depends on the column contents. You can change it.
Column Importance

In a responsive table, by default, all columns have an importance of none,

except

for list report columns for key fields. These have high importance.

You can change the level of importance.

Labels for Multiple Fields in a Column
Available in responsive tables with SAP Fiori elements for OData V4
Ascending Sort Order on a Column
Default, you can change it.
Grouping
Available in responsive and analytical tables
Number of Table Rows Displayed at Once
Work with the development team to find the best compromise between optimal user experience and optimal technical performance.
No Data Found Text
Default, replace the generic placeholder text with text that’s meaningful to the user.
Message Strip above the Table

You can display a custom message above the table in the:

  • List report, object page, and analytical page with SAP Fiori elements for OData V2
  • List report with SAP Fiori elements for OData V4

In the object page, by default, a message strip is displayed when there are errors in the table.

When there are multiple messages, the one with the highest severity is displayed.

List Report and Analytical Page Only

Availability

Number of Table Levels Expanded at Initial Load
Default, you can change the number for the tree table and analytical table.

Object Page Only

Availability

Message Strip for Rows with Errors
Default
Rows Displayed in a Grid Table

Depends on the table height, which adjusts to the available onscreen space for an object page with:

  • Anchor bar navigation and a single section that contains only a grid table
  • Tab bar navigation and a current tab that contains only a grid table

[/external_only]

Table Settings

Tooltips on Column Header Labels

Available with SAP Fiori elements for OData V4, the tooltips on the column header label feature makes sense only when the users always work on a desktop with a mouse. The users must hover on the column header to see the tooltips.

Clear All / Select All

When the selection of multiple rows is enabled for a table, both versions of SAP Fiori elements:

When the Select All action is hidden, the user can still select a range of multiple items, by selecting an item, pressing Shift, and selecting others.

For grid tables, analytical tables and tree tables, the default limit for rows the user can select at once is 200. You can change the limit. We recommend you consult the application team on how a change would impact performance.

SAP Fiori elements for OData V2 Defaults

When the selection of multiple rows (or multiselect) is enabled, the selection column header displays by default:

You can change the default.

SAP Fiori elements for OData V4

When the selection of multiple rows (or multi mode) is enabled, the selection column header displays by default the Clear All checkbox for all tables but a responsive table in an object page with anchor bar mode. In this case, the responsive table displays the Select All checkbox because the user can scroll to all the section content.

You can change the default.

For an optimal user experience only display the Select All checkbox for a small number of items because:

  • When the user clicks Select All, all the items or rows load from the backend. Loading many items can require multiple requests to the system and, consequently, take time.
  • When a responsive table contains so many rows that they cannot all be displayed onscreen, many users expect the Select All to select all the rows in the table. In fact, it selects all the rows currently displayed on the interface.
When the object page is in tab bar mode, we recommend enabling the Clear All action when the selection of multiple rows is enabled.

Column Width

The default column width varies according to the column contents:

You can can change the width.

For more information, refer the development team to Setting the Default Column Width.

Column Importance in Responsive Tables

By default:

You can change the level of importance.

The importance assigned to a column determines whether or not the table displays its values onscreen when screen space is limited:

When at least one column is hidden, the table toolbar displays the Show Details button so users can view the previously hidden columns in the table pop-in area. After the user clicks Show Details to display the column, the action changes to Hide Details.

You can also assign an importance to custom columns.

For more information, see:

Labels for Multiple Fields in a Column

By default, with SAP Fiori elements for OData V4, when a column contains a field group with more than one field, the labels for those fields are not displayed.

You can enable the display of a label for each field. The field group label then is displayed as the column title in the header.

Sort Order

By default, the sort order for a column is ascending.

You can:

For more information, see the sort guidelines according to table type:

Number of Table Rows Displayed at Once

By default, a responsive table loads the following number of rows at once:

When more rows exist, the users can click the More button at the end of the table to view additional rows.

With SAP Fiori elements for OData V2, you can change the default number.

For an object page that includes one section and one subsection, the responsive table loads 20 rows and the user can scroll to view additional ones.

Work with the development team to find the best compromise between optimal user experience and optimal technical performance.

Grouping

Grouping is available in responsive and analytical tables.

You can define the format of the grouping headers.

[internal_only][/internal_only]

Grouped Totals in Analytical Tables

For now, with SAP Fiori elements for OData V4, in an analytical table where a group contains items with different units of measure — for example the sales revenue for different countries in different currencies — the grouped total has an asterisk (*) next to it, not a number. These totals cannot yet be calculated.

Example

Country
Sales Revenue (EUR)
Sales Revenue Local Currency
> Germany
20,976,409.00 EUR
20,976,409.00 EUR
> USA
30,106,332.00 EUR
34,622,095.00 USD
> United Kingdom
13,872,516.00 EUR
12,485,187.00 GBP
Total All Countries
64,955,257.00 EUR
*

For more information, see:

No Data Found Text

By default, the following text is displayed when no data is found.

Replace the generic text with text that’s meaningful to the user.

List Report and Analytical Page Only

Initial Expansion of Table Levels

By default, on initial load, the following expandable tables are expanded to this number of levels:

You can change the default value for the tree table and analytical tables.

For more information, refer the development team to Initial Expansion Level for Tables in List Reports & Analytical List Pages.

Object Page Only

Message Strip for Rows with Errors

When table rows contain errors, a message strip is displayed above the table. It contains a Filter Items link that lets users see only the rows with errors. After the users click the link, a Clear Filter link replaces it.