[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

 
 

Configurations

With Left Region

 
 

With Secondary Label

 
 

With All Configurations

 
 

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)
    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.
  • Left Agnostic Region
    The menu item can have an agnostic region on the left side of the menu item. It has pre-built spacing to dictate the proper 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.
  • Secondary Text Label (Optional): "b4" (New Typography Variant)
    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.
 

Responsive

This composable uses the Standard Menu responsive behavior.

 

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

This composable has no known-of related A11y concerns.


Variants

This composable has no known-of variants.


Usage Warnings

This composable has no known-of usage warnings.


Reference

This composable has no known-of references.