Intro
In this section you will find more information about the following info popover variants:
- Info Labels
- Browser Tooltips
- Performance Optimization Popovers
- Semantic Info Popovers
- Token Popovers
Info Labels
For situations where additional contextual information is essential to perform an action or understand the UI, Info Labels (custom component) should be used instead of Info Popovers. Info Labels allows the information that would otherwise be contained within an Info Popover to be displayed beside its related object in a more discoverable way.
- Info Icon: The info icon should be the --sapContent_NonInteractiveIconColor. The icon font-size is 16px by default with 0.5rem padding between icon and label text.
- Info Label Text: The info label text should be short and provide essential instructions that should not be hidden to guide the user in completing their task. The text should not be italicized as there are no supporting variables for italics. Use the Label component for the info label text.
Info Label beside Input Fields
Browser Tooltips
Info Popovers allow users to pull additional contextual information for a given object (ie. an Info Popover for a story may show the user the story creation date, creator, last modified date, etc.). However, Browser Tooltips should be used in situations where there is a UI element with no descriptors. Examples of situations where browser tooltips are appropriate include:
- An element without a label
- An icon-only button with no descriptor
- In-place information within a map
- Button that contains only an icon and a number
Refer to the Fiori guidelines for more information on browser tooltips usage.
Browser Tooltip for Icon Button
Use the Browser Tooltips:
- For UI elements without labels
- For Icon-only button
- In-place information in a map
- When showing a button with only an icon and a button
Don’t use Browser ToolTips:
- To replace a label for a form item; a label should always be used
- If the content of the tooltip is redundant
- If you want to provide additional information or context, instead use Info Popovers.
- On column headers of tables
Performance Optimization Popovers
Performance Optimization Popovers are used for providing users with tips related to optimizing their usage of product features. For example, when creating a map on SAC stories, a Performance Optimization Popover may provide a tip on how to optimize the map. These popovers are longer than the standard Info Popovers and the 1-2 sentences rule does not apply.
- Performance Icon: Use the performance icon from the fpa-icons library to represent Performance Optimization Popovers. This differentiates these popovers from Info Popovers which are represented by the message-information icon.
- Header Text: Performance Optimization Popovers have header text that differentiates them from standard Info Popovers. The header text provides a brief summary of what the performance optimization tip is.
Performance Optimization Popover
Semantic Popovers
Validation Popovers
Semantic Validation Popovers are used to provide semantic feedback and validation messaging. The popover is triggered by clicking a UI5 Object Status control.
Semantic Popovers - Error
Semantic Popovers - Warning
Semantic Popovers - Success
Semantic Popovers - Informative
- Semantic Icon: The ‘status-information icon is used for Semantic Info Popovers, the ‘status-critical’ icon is used for Warning Info Popovers, and the ‘information’ icon is used for Informative Info Popovers. Semantic popovers all use filled-in icons.
- Header Text: Describes the context of the error or warning message.
Exceptional Cases
In this section you will find more information about the following topics:
- Header Groups
- Token Popovers
Header Groups: Multiple Messages
In situations where multiple messages are displayed within one popover, headers group these messages together. This is applicable for semantic popovers as well. Rather than using the Message Popover component, a popover with various messages should have an icon+header for each respective message.
Semantic Error Popover with Header Groups
Token Popovers
Token Popovers are specific to the token component. These popovers include an arrow and is placed directly around the token component.
- Icon Control: The icon resides in the trailing container of the data token. Hovering over the icon will open the popover.
- Popover: The popover is aligned with the data token component.
Semantic Error Popover within a Token
Popovers with Forms
These popovers have their content consist of an object’s metadata. The metadata is represented via a form with labels and text controls.
- Header: Optional element that provides more context to the user on what the popover is for.
- Label: The content of the Info Popover is a list of Form Items with a Label and a Text control.
Semantic Error Popover within a Token
Popovers with a Link
These popovers contain a Link control that directs users to another page or tab. These are for popovers that contain brief information that may need more context.
- Link: Directs the user to a location with more contextual information for the Info Popover’s content. Usually has text reading ‘Learn More...’ or ‘See More...’.
Info Popover for a Data Token
Localization
The Info Popover should be mirrored for RTL languages. This includes the way the text within the popover is written along with the arrow position and where the popover is displayed respective to the icon control.