Message Popover

sap.m.messagePopover

Intro

The message popover (sap.m.MessagePopover) control can handle multiple messages within SAP Fiori. In combination with a message manager, it automatically displays messages that occur after validation points.

With the message concept, we now provide a way to centrally manage messages and show them to the user without additional work for the developer.

Message popover

Usage

Use the message popover if:

You want to display multiple messages to the user.
You do not want to interrupt users while they are performning an action.

Responsiveness

Size S (Smartphone)

On smartphones, the message popover is automatically shown in full-screen mode.

Full-screen message popover on a smartphone

Layout

Full Screen Layout

In a full screen layout, the messaging button always appears on the left side of the footer toolbar.

Messaging button in full screen layout

Split-Screen Layout

In a split-screen layout, the messaging button always appears on the left side of the footer toolbar of the details. Messages are usually field-related (for example, to a business object).

Messaging button in split-screen layout

Messaging Button

If there are no messages to display, you do not need to show a messaging button. The toolbar then only includes the “normal” actions related to the object.

If there are messages to display, the messaging button must look like the example shown in the figure on the right.

Messaging button in toolbar

How to Display the Message Popover

An overview of the different steps needed to display the message popover is provided below. For further information, see message handling.

Behavior and Interaction

Navigate to Details

The message popover uses the sap.m.List control, which provides truncation. If the message cannot be fully displayed or includes a long description, the message popover provides navigation to the detailed description.

Message popover list view

Detailed view

Guidelines

Messaging Overview

No messages to display

If there are no messages to display, you do not need to include a message button in the toolbar.

Highlight the fields

First, highlight the specific field(s) if possible, and change their value state according to the type of message, such as error, warning, or success messages.

Message popover

In addition to the field(s) being highlighted, a button also appears in the toolbar, displaying an icon and the number of messages that have occurred. This number matches the number of fields that have been highlighted. Whenever multiple messages occur, they should be displayed in the message popover, which can be triggered via a button on the left side of the footer toolbar.

Display single messages in a message box

There may also be messages that have to interrupt the user. At present, we are only aware of technical issues such as network errors and connection issues.

Validation Points

No guidelines are currently available regarding data validation. Several cases are possible, which depend on the users, the performance, and the data that needs to be validated. These cases include:

After focusing out
After pressing a key
After clicking or tapping an action, such as Save or Submit

Resources

Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.

Elements and Controls

Message Handling (guidelines)
Message Box (guidelines)

Implementation

Message Popover (SAPUI5 samples)
Message Popover (SAPUI5 API reference)