[Composable] Activation

Overview

Activation is the simplest and most commonly used menu item in the menu-button widget. It should be the default choice in most scenarios due to its straightforward nature. This simplicity makes it highly reliable, as it minimizes the risk of edge case semantic issues during the design process.

As a basic, clickable option, the Activation item triggers direct action directly changing page content without any additional layers or interactions (e.g., hierarchy or selection behavior). This item type should be favored whenever possible to maintain simplicity and alignment with accessibility standards.


Design

 
 

Box Model

The primary label by design is an opinionated configuration and has forced styling and alignment. It has a left placement of the text that grows to the right and is forced to wrap to accommodate additional labels that are displayed in full length.

 
 

Configurations

With Left Decorator

The menu item can have an agnostic region on the left side of the menu item. It has pre-built spacing to allow for enough distance between the primary label, but still within close proximity to maintain the relationship. This region can be used for a decorative element to provide better understanding of various actions to be taken.

 
 

With Secondary Label

The secondary label by design is an optional opinionated configuration and has forced styling and alignment. It has a right placement of the text that grows to the left, and pre-built spacing to always maintain sufficient space between the primary label.

The secondary label never wraps and is always displayed in it's full length to take as much space as it needs. This forces the primary label to wrap to accommodate it. Secondary labels should be used sparingly and only for text strings that are short and concise. Authors are in charge of ensuring the primary and secondary relationship through the display of content.

 
 

With All

Showing all configurations used together.

 
 

This composable uses all the visual styles from the Standard Menu, and may also include any of the following according to the use case and requirements.

  • Primary Text Label: "b2" (Typography Variant)
  • Secondary Text Label (Optional): "b4" (New Typography Variant)
  • Background: neutral-000 (#FFFFFF)
  • Margin / Padding: Left / Right 16px, Top / Bottom 8px
  • Min-Height: 32 RT
  • Min-Width: Stretches to fit content
  • Max-Width: Stretches to fit parent
 

Responsive

Same as the standard menu item

 

States

StateDefault GraphicDefault Styling
Idlebackground: neutral-000 (#FFFFFF)
font: b2 (typography variant)
font-color: neutral-700 (#353C46)
left-icon-color: brand-800 (#005181)
secondary-label-font: b4 (new variant)
_font-color: brand-800 (#005181)
font-style: italic
N/A
Focusbackground: brand-200 (#EBF6FF)
border: 1px solid brand-500 (#1394E5)
N/A
N/A
N/A
Disabledfont-color: neutral-500 (#697489) - new variant
cursor: disabled
left-icon-color:
neutral-400 (#8C93A6)
secondary-label-font: b4
font-style: italic - new variant
N/A
Hoverbackground: brand-200 (#EBF6FF)
N/A
N/A
N/A
Read-onlyN/AN/A
ErrorN/AN/A
 

Use Cases

Original Scenario (Use Case)Dim Sum Version (Proposed Solution with DS Components)Scenario Description
Activation Menu

Shown in a Toolbar located above a Data Table (using an overflow icon-only button)
Activation Menu with Left Decorator

Shown in a Page Header Toolbar (triggered from an overflow icon-only button)
 

Examples

Scenario GraphicScenario SolutionText Resize and Reflow (200%)Scenario Description
Activation Menu menu consisting of menu items (labels) for taking immediate action on one or more items. When standard action occurs and no visual representation is needed.
Activation Menu with Left Decorator menu configured with a left decoration icon for better understanding of various actions to be taken.
 

Digital Accessibility

Same as the standard menu item


Variants

Not applicable


Usage Warnings

Same as standard


Reference

Not applicable