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
State | Default Graphic | Default Styling |
---|---|---|
Idle | background: 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 | ||
Focus | background: brand-200 (#EBF6FF) border: 1px solid brand-500 (#1394E5) | |
N/A | ||
N/A | ||
N/A | ||
Disabled | font-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 | ||
Hover | background: brand-200 (#EBF6FF) | |
N/A | ||
N/A | ||
N/A | ||
Read-only | N/A | N/A |
Error | N/A | N/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 Graphic | Scenario Solution | Text 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