Menu

The Menu component displays the list of action items that are revealed when the user clicks on the trigger element.

OverviewPropertiesUsageAccessibilityChangelog3.14.0

Changes to Menu. The full components changelog also lists package-wide and cross-cutting entries.

3.14.0

Updates

Overlays

• Fixed the issue that left keyboard focus outside a dialog that was opened from a Menu.Item. (APPDEV-19146)
• Fixed the trigger button missing explicit aria-haspopup="menu" and aria-expanded attributes, which prevented screen readers from correctly announcing the expanded/collapsed state. (APPDEV-19175)
• Fixed the group divider lines not being rendered between Menu.Group blocks in mobile mode (viewport ≤ 480 px). (APPDEV-19585)
• Fixed the slide-in animation in the mobile menu still playing when prefers-reduced-motion is set to reduce. (APPDEV-19885)
• Fixed the dropdown content being cut off at narrow viewport widths, which caused horizontal scrolling and violated WCAG 1.4.10 (reflow). (APPDEV-19215)

3.13.0

Updates

• Menu.Group now accepts a label prop that renders a heading and names the group for assistive technology. A Menu.Label rendered inside a Menu.Group also becomes that group's accessible name automatically, so you no longer have to pair an id with aria-labelledby yourself. (APPDEV-18962)
• You can now soft-disable a Menu.Item with aria-disabled to keep it focusable and announced to screen readers while showing its Menu.ItemTooltip on desktop, so you can explain why an item is unavailable. Unlike the hard disabled prop, a soft-disabled item stays interactive and still fires onSelect, leaving the behavior to you, and selecting it does not close the menu. (APPDEV-19690)

3.11.3

Updates

• Disabled Menu.Item elements are no longer reachable via keyboard navigation. (APPDEV-18649)
• The Menu.Trigger now sets aria-controls referencing the open menu content, allowing screen readers to announce the expanded state correctly. (APPDEV-19170)

3.11.0

Updates

General

• Overlays such as Tooltip, Menu item tooltips, Select and FilterField suggestion lists, FeatureHighlight, and chart tooltips no longer flash briefly in the top-left corner of the screen before moving to their final position. (APPDEV-19359)
• Menu.Item and Menu.Link no longer cause a React console warning when textValue is passed. (APPDEV-18440)

3.10.5

Updates

General

• Overlays such as Tooltip, Menu item tooltips, Select and FilterField suggestion lists, FeatureHighlight, and chart tooltips no longer flash briefly in the top-left corner of the screen before moving to their final position. (APPDEV-19359)

3.10.0

Updates

• On mobile viewports, Menu now renders as a full-screen drill-down panel instead of a fly-out dropdown. Sub-menus open as a new level users can navigate into, with a back button to return to the previous level. Desktop behavior is unchanged. (APPDEV-18330)

3.8.0

Updates

• Fixed nested submenus overflowing the viewport on mobile screens. Submenus now stack inline below their trigger at viewport widths ≤ 480px, and long menu item text truncates with ellipsis. Desktop behavior is unchanged. (APPDEV-18058)

3.6.0

Updates

• Fixed several outside-click dismissal issues on the Menu component. (APPDEV-16531)

3.5.0

Updates

• Now checks whether code is running in a browser before accessing browser-only APIs, preventing potential SSR (server-side rendering) issues. (APPDEV-17212)

3.4.0

Updates

• The Menu trigger now correctly shows its active state when the Menu is open. (APPDEV-16688)

3.2.0

Updates

• Stop calling the SDK function getIntentLink twice when the Menu.Intent component is rendered. (PAPA-32034)