(this page was created automatically. In case of formatting issues, please visit the official Wiki Page)
Action Placement
Overview
Actions trigger functions, such as saving or deleting a business object. They can also trigger navigation to another dashboard, where the action can be executed, described in detail, or checked further. Actions are displayed in the form of action icons or buttons.
Actions that refer to a content are displayed at the top of the boardlet, next to the title that identifies the object. Actions that relate to the task workflow are located at the bottom right and can be performed after working through the content.
To make actions easier to organise and find, they are usually placed in toolbars. Depending on the content that is affected by the action, different toolbars are available. Within the tool bars, some actions are usually more important than others. Refer to the arrangements in the below examples for better understanding.
Actions are always distinguished from pure navigation. Navigation functions are always on the left, such as Home or Breadcrumbs, while actions in toolbars are aligned on the right.
Anatomy
Actions can be categorized into three groups: Toolbar Actions, Footerbar Actions, and Content Actions. More information on each can be found in their respective pages.
Toolbar actions
Toolbar actions are an important part of action placement. They control functions of the content as well as the container. Toolbar actions are represented by action icons. If more than the allowed number is needed, group them in an overflow “More” menu. The allowed number is depending on the context.
Toolbars appear in different organisms and follow specific rules. Use the following placements and constraints.
| Name | Use Case |
|---|---|
| Header toolbar | Actions that affects all applications and the entire user environment. It sits in the header area. |
| Boardlet toolbar | Actions controling a single boardlet and its content. It is always on the top- right side of the boardlet. |
| Ghost boardlet toolbar | It follows the boardlet toolbar rules with one exeption: The first actionbar has only one “More” icon. |
| Card toolbar | Card-secific actions like “Expand/Collapse” if the card supports expand. All other actions are gouped under a “More” icon. |
| Dialog toolbar | It contains actions related to the Dialog and follows boardlet behavior. |
| Table row toolbars | Actions that pertain to a single row of a table. They always control functions of the entire row. |
For more information, please go to [Toolbar Actions].
Footerbar actions
The footerbar controls the workflow of the organism they is placed in, usually a boardlet. Actions related to the workflow are always at the bottom of the organism.
The footerbar has a fixed height and must never be multiline. Use only the allowed combinations.
- Tabs only. Tabs are arranged side by side. There is no default number of tabs. Exeptions: Vertical tabs are placed below each other.
- Tabs with buttons. Use this when the boardlet has multilayer content and a content action. If an action exists only in one tab, show it disabled in all other tabs to avoid visual jumping. The number of possible actions is limited to a maximum of two buttons.
- Buttons only. Use this when an action is required in the boardlet. The number of possible actions is limited to a maximum of two buttons.
- Tabs with actionbar. Use this as a secondary display option. It can be used in kiosk mode to control tab rotation and timing.
For more information, please go to [Footerbar Actions].
Content actions
Content actions are placed directly in freely selectable content. They can appear in the content area of a boardlet, dialog, modal, or free-standing content.
Content actions exist in three categories.
- Inline actions. The action molecule or organism is not enclosed by a body. The action is always on the left inside the molecule or organism.
- Actions. These actions also have no enclosing body. The action is always on the left inside the molecule or organism.
- Table Actions. They are placed inside an action column inside a table. Each row has the same actions. Actions effect the entire row.
For more information, please go to [Content Actions].
Best practices
Place and align
Place actions as close as possible to the content they affect. For example, if an action only effects one items inside a boardlet, consider putting it into a content action rather than a toolbar action.
Keep alignemnt and order of actions inside organisms and toolbars consistent across the application. The same action should be found at the same place across boardlets and dashboards.
Choose the right pattern
Use a Toolbar action when the function controls the content or its container. This includes boardlets, cards, dialogs, or a whole table row.
Use a Footerbar action when the function advances or finalizes the workflow of the organism. Keep to the allowed combinations and the fixed single-line height.
Use a Content action when the function belongs inline to a specific field, record, or piece of content.
Action order and emphasis
Follow this order in the Header toolbar. Place business actions first and then content management actions. Place layout management actions next and then generic actions. It is recommended to place the action most important for your business context on the very left within its group.
For the Footer toolbar, place the primary workflow or finalizing action on the rightmost position. Going right to left, place secondary actions next and then the negative path. When choosing buttons, only use one primary action button per organism, and if possible also page.
Toolbar capacity and grouping
Do not place more than three actions per boardlet toolbar. Group additional actions under the More action. List grouped actions in an overflow menu. A boardlet has actions, it must always include the More action. The second actionbar must not exist without the first.
Hierachy of Actions
The buttons follow a hierarchical order. It is important that you create a visual hierarchy between the buttons in your user interface. The hirachie moves linearly from right to left.
