Intro
The card header contains essential information about the card and its associated detail page. It provides a quick overview of the basic attributes, such as the title, subtitle, and status of the card.
Card header design in the web card system
Top Tips
- Use the header to display essential information, such as the title, subtitle, avatar, and other key information.
- Keep texts in the header short and precise.
- Only one button is allowed on the card header. If you need to offer more actions, use a context menu.
- Don’t overcrowd the card header with too many elements.
- Don’t place complex components, like a calendar, in the card header. Use the card body instead.
- Don’t use the card header to provide detailed information (long text). Use the card body instead.
- Don’t place an action button that triggers a workflow in the header. Place it in the card footer instead.
- Don’t add more than three rows to the extended header.
Anatomy
undefined
Card Header
Schematic header anatomy
Anatomy - example header
- Card Header: Contains a flexible combination of 3 block areas: main header, numeric header, and extended header.
You can combine the blocks as needed for your use case. - Main Header: Contains essential information about the card. In addition to the title, the main header can include a subtitle, thumbnail, button, and counter.
- Extended Header: Contains additional elements that provide more information, such as a status, rating, tags, text, or a numeric value.
- Numeric Header: Contains a KPI. The numeric header can include additional indicators related to the KPI, or a micro chart that presents the data graphically.
Main Header Components
-
Avatar (optional): An image, icon, or initials.
-
Title: Describes what the card is about.
-
Subtitle (optional): You can use the subtitle to qualify the title, offer an explanation, or show a status. The use of the subtitle can differ, depending on the card type.
-
Counter (optional): Displays how many items are on the card in relation to the total number of relevant items.
- Format: [Items on Card] of [Total Items]
- Example: 5 of 40
-
Interactive element (optional): For example, an icon button. Typically, the button in the card header is used for actions provided by the host environment, such as Refresh, Favorite, or Bookmark.
Example of main header components
- For header actions, always use an icon button as the interactive element on the top right.
- If you need to provide more than one action, use a context menu.
Extended Header Components
The extended header is a flexible slot for custom combinations of UI components.
Components are placed in columns, preferably in a one-column or two-column layout.
If space is limited, the components can wrap to the next line. We recommend a maximum of 3 lines.
Extended header - example with 3 lines and a two-column layout
You can also combine content within one line, such as a rating followed by a label.
When multiple components are shown in one row, you can separate them with a visual divider.
Extended header - visual divider between components
The alignment within the slots is flexible. Content can be aligned to the left, right, top, or bottom.
We assume that most cards will use one of 3 typical layouts:
1. One-column layout, components left-aligned
2. One-column layout, components right-aligned
3. Two-column layout, left column is left aligned, right column right-aligned
Extended header - layout and alignment options
If a main header with a thumbnail (avatar component) is shown above the extended header, you can indent the UI components in the extended header. This allows you to vertically align the texts.
- Extended header aligns with the avatar of the main header.
- Extended header aligns with the texts of the main header.
The extended header can be aligned with the avatar or text of the main header
Recommended:
- Use a maximum of 2 columns.
- Use a maximum of three rows.
- Add a visual divider when different components appear side-by-side in one row (for example, an object status, text, and rating indicator).
Numeric Header Components
- KPI / numeric value: This value can use semantic colors.
- Label (optional): Additional qualifying information to provide a better description of the key value. This text truncates after one line.
- Side indicators (optional): If required, you can also display up to two additional indicators that relate to the main KPI.
- Micro Chart (Optional): You can add a micro chart to present your data graphically. The recommended sizes for micro charts are XS, S, or M, depending on the available space.
The height of the numeric header block can be set to either “hug contents” or “fill the container.” If the numeric header block is the last block in the card and the components are bottom-aligned, the numeric header block can also fill the container.
Examples of numeric header components
Types
Header blocks can be combined flexibly to meet the requirements for different use cases.
- The main header is aligned to the top of the card.
- The order of the numeric header and extended header is flexible, based on the use case or the guidelines for the respective product.
- The numeric header and extended header can be aligned to the bottom of the card to achieve a tile-like design.
Examples of different header block combinations
Behavior and Interaction
Interactive Header (main header as interactive element)
The main card header can be designed as an interactive header. This means that users can select the main header to navigate to a designated page or view with more details.
In this case:
- The card can’t be interactive at the same time.
- Only the main header triggers the navigation. The numeric header and extended header are not part of the interactive header.
Clicking the interactive main header triggers navigation to the detail view
Actions in the Header
Both the main header and the extended header can have interactive elements:
- Main header: The interactive element is usually used for generic card actions (for example, to refresh, favorite, or remove the card ).
- Extended header: You can include interactive elements in the extended header to give users easy access to actions related to the header information (for example, write an email, make a call).
Interactive elements in the main header and extended header
Interaction in an Interactive Header
When hovering over the button in an interactive header, both the main header and the button change to the hover state (H).
Clicking the button in the main header changes only the button to the focus state (F).
Triggering the interactive element on the header wins over triggering the interactive header.
Interaction behavior - interactive header with interactive element
Interaction in a Non-Interactive Header
When hovering over the button in a non-interactive header, only the button gets the hover state (H). The state of the main header doesn’t change.
Clicking the button in the main header changes only the button to the focus state (F).
Interaction behavior - non-interactive header with interactive element
Responsive Behavior
1. Main Header
- The avatar, title, and subtitle stay left aligned.
- The button and counter stay right aligned.
- If the card width is decreased, the text of title and subtitle wrap to two or a maximum of three lines (recommended). After that, the text truncates with the ellipsis (…).
- The counter never truncates.
2. Extended Header
-
The components in the left column stay left-aligned. If the width is insufficient, the components displayed in one line (N) wrap to two lines (similar to text wrapping behavior).
-
The components in right column stay right-aligned until the card is no longer wide enough to display two columns. Depending on the importance of your content, you then have two options:
- Pop-in: The content from the right column moves (or “pops in”) below the left column components and changes from right-aligned to left-aligned.
- Hide: The content from the right column in no longer shown.
3. Numeric Header
- The numeric value and label stay left aligned.
- The numeric value never truncates.
- Label gets truncated after one line.
- When the card’s width is increased, the first side indicator stays maximum 3 rem distance (M) from the numeric value.
- When the numeric header has space for a micro chart, the micro chart can be displayed after KPI and side indicators and stays right-aligned.
- When the card’s width is decreased, the minimum distance between KPI, side indicator and the micro chart is 1 rem.
- When the width is not enough to display all elements(numeric value, side indicators and micro chart), the micro chart is hidden first, then the side indicators.
Responsive behavior of header blocks when the size of the card is changed
Related Links
Specifications
- Web Card System
(visual design) - Card Header in Web Card System
(interaction design)