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)
Full-screen message popover on a smartphone
Layout
Full Screen Layout
Messaging button in full screen layout
Split-Screen Layout
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
[internal_only]Guidelines will be made available in the future to ensure that we achieve consistent validation behavior within SAP Fiori.[/internal_only]
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)
Visual Design
- [internal_only]Message Popover (visual design specification)[/internal_only]
- [external_only]No links.[/external_only]