Intro

The object view is a floorplan for displaying objects in SAP Fiori. It can either be embedded in a master-detail app (as in typical approval apps) or shown as a full-screen page. This floorplan offers optimal support for multiple devices.

The object view is suitable for both simple objects and more complex, multi-faceted objects. You can use a tab container to present the information in different categories.

For editing, the layout switches to a flat object view. In other words, all the sections that were presented as tabs appear together on one long page. Switching to this flat layout prevents user input and validation errors from being scattered across multiple tabs.

Object view on a desktop device with letterboxing

Object view on a desktop device with letterboxing

Usage

Use the object view floorplan if:

Do not use the object view floorplan if:

Structure

The object view floorplan comprises the following elements, from top to bottom:

  1. Launchpad shell bar: Always available at the top of SAP Fiori apps.
  2. Application header: Reflects the title of the launch tile, such as Manage Products.
  3. Object header
  4. Tabs (optional): If your content falls into different categories, or you want to display different tables, you can embed the content in an icon tab bar.
  5. Content area: The main part of the screen for displaying your data. You can use lists, tables, tree tables, or charts.
  6. Footer toolbar

Structure of object view floorplan

Structure of object view floorplan

Responsiveness

Object view on a phone

Object view on a phone

Object view on a tablet

Object view on a tablet

Object view on a desktop

Object view on a desktop

You can use the object view floorplan in both a full screen layout and a split-screen layout.

Object view in a split-screen layout

Object view in a split-screen layout

Tabs

The key element of the object view is the icon tab bar. Each of the tabs shows a certain facet of the object. There are two primary facet types:

  1. Form-based facets display attributes of the object in a form layout (for example, object details or contact details).
  2. Tabular facets show a list of similar attributes or relationships in a list or table structure (such as attachments, contacts, or products).

Defining Tabs

You can define tabs as expandable, allowing users to show or hide the tab content as needed.

You can also define the default tab that is selected when the user opens the application. This might not always be the first tab on the left. However, you should ensure that the tab state is consistent for object views of the same type. This gives the user a coherent user experience when navigating between object views.

The user can switch between the object facets by just switching tabs. You can display additional information below the tabs.

Object view with text-only tabs

Object view with text-only tabs

In the object view, you can use the following tab types:

  1. Icon tabs: Use icons if you only need the standard tabs, such as information, attachments, and notes.
  2. Text only: Use text if you need tabs for other (non-standard) object facets.

Guidelines for choosing a tab type:

Don't

Using actions specific to tabs

Using actions specific to tabs

Don't

Using actions specific to tabs

Using actions specific to tabs

Do

Using actions specific to tabs

Using actions specific to tabs

Do

Using actions specific to tabs

Using actions specific to tabs

The footer toolbar in the object view floorplan is global. Actions in the footer toolbar must not change when the user switches tabs. If you need to include actions that relate to a specific tab (facet), include them in the tab content. For example, if the tab contains a table, offer actions in a table toolbar.

Flows and Variants

Create

The create action creates a new object. The corresponding button can either be a plus (:icon-add ) sign button or a button with a meaningful text (such as Add Product). When the user creates a new object, the display changes to a flat object view in edit mode. Switching to this flat layout prevents user input and validation errors from being scattered across multiple tabs.

In the flat object view, users can fill out the details and save the object. After saving, the new object is shown using the standard object view. If the user navigates away from the object without saving the entries made so far, the app warns the user with a data loss dialog.

Edit

We recommend using the flat object view in edit mode (as for the “create” scenario above). When the user clicks or taps the Edit button, the floorplan switches from the display mode with tabs to the edit mode with the flat object view. The Edit button is replaced by the Save and Cancel buttons. Switching to this flat layout prevents user input and validation errors from being scattered across multiple tabs.

Save or Cancel takes the user back to the display mode of the object view with tabs. Cancel ignores any changes made, while Save keeps the changes. If the user navigates to another object or navigates away from the edit page without saving, the app warns the user with a data loss dialog.

If the object view does not have any tabs, the page keeps its layout and structure in edit mode. For more information, see the manage simple objects.

Exception: If the object view includes tabs, but only a few tabs have editable fields, you can also use in-place editing and keep the structure of the tabs. In this case, the edit button is positioned next to the editable content (see manage parts of an object for details).

Object view – Edit flow behavior

Object view – Edit flow behavior

Object view on a desktop device

Object view on a desktop device

Edit mode – Object view switches to a flat object view

Edit mode – Object view switches to a flat object view

Attachment tab in an object view – Modeless editing

Attachment tab in an object view – Modeless editing

While the edit mode involves switching to a flat object view, some elements support “modeless” editing. These elements can be changed in both display and edit modes.

For example, adding a new attachment is a one-click action that is guided by a dialog. This action can be triggered without switching to edit mode. Any errors that might occur can be handled during this creation process.

If you do not want to switch to a global edit mode, you can encapsulate your action in a dialog. Example use cases include:

Guidelines

Visual Design

The object view floorplan has no visual design of its own, but application design and development should ensure that the margins and paddings are similar to the normal page layout. For example, the controls should have the same margins inside the side content container.

Basic layout of the object view on a smartphone

Basic layout of the object view on a smartphone

Basic layout of the object view on a tablet

Basic layout of the object view on a tablet

Basic layout of the object view on a desktop

Basic layout of the object view on a desktop

Basic layout of the object view on a desktop – Split screen

Basic layout of the object view on a desktop – Split screen

Resources

Elements and Controls

Implementation