Intro
A link (also known as a hyperlink) is an interactive text element. It is typically used for navigation, allowing users to move between different pages or sections of an application.
Link
When to Use
Do
Use the link:
- To navigate to another page.
- To jump to an anchor.
- To open an external URL.
- To link to a specific object.
Don't
Don’t use the link:
- To trigger actions. Use the button.
- If the link text is the key identifier of an object. In this case, use an actionable object identifier instead.
- If there is no target or reference to be linked to.
Anatomy
A link is a clickable text element, typically shown in a different color and with an underline.
- Icon (optional)
- Text (in blue color)
- Underline
Anatomy of a link
Types
There are four different link types:
Link types
A. Default: Displays a clickable text link with standard styling.
B. Emphasized: For links that require higher visibility text is bolded.
C. Subtle: Use subtle links to distinguish between important (default) and less important (subtle) links when the app page is full of various links (10+). Subtle links allow you to improve the visual hierarchy in large lists and tables.
D. Link with Icon: Use the link with an icon when the user expects and profits from the icon in the UI context. Please note that the icon is supportive, which means that it supports the text next to it. Therefore, a tooltip is not required. Do not use the icon for additional information.
Behavior and Interaction
Links let users access objects or navigate. They offer visual feedback for the hover and focused states.
If a link is unavailable, display the disabled state - for example, when part of the content area is disabled.
Link states
A. Regular state: The default link appearance in its normal state - without hover or focus, and without an underline.
B. Hover state: The link appears underlined on hover to indicate that it’s interactive.
C. Visited state: The link retains its regular appearance after being visited. No visual change is applied in the visited state.
D. Down state: The link retains its regular appearance when pressed. No visual change is applied in its down state.
E. Disabled state: The link appears faded and is not interactive when disabled, indicating that it cannot be selected or triggered.
Responsiveness
A link can wrap or truncate, depending on the layout. Favor wrapping over truncating and keep the link text short and meaningful.
For more information and guidelines on the responsive behavior of text, see Wrapping and Truncation.
Wrapped link
The link text automatically wraps to the next line when there isn’t enough horizontal space, so the full content remains visible on all screen sizes.
Wrapped link
Truncated link
The link text is truncated and ends with an ellipsis when space is limited, to maintain layout consistency in narrow containers.
Truncated link
Localization
For right-to-left languages, such as Arabic or Hebrew, the link is mirrored.
Accessibility
To conform with the international Web Content Accessibility Guidelines WCAG 2.2, set the line height for links as follows:
- For links within continuous text or in a text area: Don’t increase the line height. Increasing the height can misalign the text with the links or cause uneven spacing between lines. In these cases, there is no need to increase the line height because no other actions are attached to this type of container.
Related Links
Elements and Controls
- Button (guidelines)
- Object Display Components (guidelines)
- Wrapping and Truncating Text (guidelines)
Implementation
- Link (SAPUI5 samples)
- Link (SAPUI5 API
- Button (SAPUI5 samples)
- Button (SAPUI5 API reference)
- reference)
- Object Identifier (SAPUI5 samples)
- Object Identifier (SAPUI5 API reference)
Elements and Controls
- Button (guidelines)
- Object Display Components (guidelines)
- Wrapping and Truncating Text (guidelines)
Implementation
- Link (SAPUI5 samples)
- Link (SAPUI5 API
- Button (SAPUI5 samples)
- Button (SAPUI5 API reference)
- Object Identifier (SAPUI5 samples)
- Object Identifier (SAPUI5 API reference)