In-context actions

In-context actions are performed on only one resource. For example, actions related to specific data in a container, such as Manage tags. They should be placed contextually with the item they relate to. This helps speed up task completion for commonly used actions.

In-context actions should be placed in consistent and predictable locations in the interface.

• Containers: Use the header to display the actions. Follow the guidelines for header component with actions.

• Dashboard items: Use the header slot of the dashboard item. Follow the guidelines for dashboard items.

• Tables:

  • Place these in the last column either as an inline icon button dropdown, an inline icon button, or a inline link button, depending on the action type. To maintain the visibility of available actions in table rows we recommend enabling the sticky table column feature to maintain visibility of the available actions.

  • When considering which actions to place as in-context actions in table rows, consult user data for commonly used actions that speed up repetitive tasks for your users.

  • You can persist one or two repetitive actions as a link or icon button to speed up task completion. In case of more than two actions, group them in a button dropdown to conserve space.

  • If there are no repetitive actions then place all actions in a button dropdown to conserve space.

  • For actions that are interconnected with a resource status, display the status column to inform users about the relationship. For example, for a reboot action, the status column should show that the resource is active.

• Cards: Use the header or content area of the card to feature the actions. Follow the guidelines for cards.

Use the inline icon button dropdown for in-context actions to reduce visual noise and optimize content density. For example placing download, copy, and share actions in an icon button dropdown.

For extra clarity, provide a tooltip with inactive actions that explains why the action is unavailable. These tooltip explanations should be as short as possible, with longer descriptions belong outside the dropdown component. Follow the guidelines for disabled and read-only states.

• Use sentence case, but continue to capitalize proper nouns and brand names correctly in context.

• Use end punctuation, except in headers and buttons. Don’t use exclamation points.

• Use present-tense verbs and active voice.

• Don't use please, thank you, ellipsis (...), ampersand (&), e.g., i.e., or etc. in writing.

• Avoid directional language.

  • For example: use previous not above, use following not below.

• Use device-independent language.

  • For example: use choose or select not click.