GlassBarItem.menu constructor

const GlassBarItem.menu({
  1. required Widget icon,
  2. required List<Widget> menuItems,
  3. GlassMenuAlignment? menuAlignment,
  4. double menuWidth,
  5. double? menuHeight,
  6. LiquidGlassSettings? menuSettings,
  7. Object? id,
  8. String? label,
  9. GlassBarItemBackground background,
  10. Color? tintColor,
  11. GlassBarItemAxisBehavior axisBehavior,
})

An icon that opens a GlassMenu pull-down, mirroring UIBarButtonItem.menu — the standard iOS 26 overflow button.

The whole capsule morphs into the menu rather than just the icon's slot, matching iOS 26's GlassEffectContainer behaviour and GlassButtonGroupItem.menu. Only the first menu item in a cluster opens a menu; a second is treated as a plain icon.

menuItems takes GlassMenuItem and GlassMenuDivider widgets — the same contract as GlassMenu.items. An open menu is dismissed if navigation starts underneath it.

menuSettings is the glass of the menu panel. When null, the menu takes the glass of the capsule it morphs out of.

Implementation

const factory GlassBarItem.menu({
  required Widget icon,
  required List<Widget> menuItems,
  GlassMenuAlignment? menuAlignment,
  double menuWidth,
  double? menuHeight,
  LiquidGlassSettings? menuSettings,
  Object? id,
  String? label,
  GlassBarItemBackground background,
  Color? tintColor,
  GlassBarItemAxisBehavior axisBehavior,
}) = GlassBarMenuItem;