Struct MenuPopup 

pub struct MenuPopup { /* private fields */ }

A trigger that opens a MaterialMenu in Kit’s popover overlay.

open is controlled: Kit’s popover reports pointer toggles, outside clicks and Escape through on_open_change, and an activated item closes the menu the same way (unless Self::close_on_activate is off). Keyboard activation of the trigger itself is the caller’s (e.g. its button’s click handler).

A cascading sub-menu (Self::submenu) opens beside the item that owns it, on the side away from the popup’s anchor edge, with the same reveal motion. Right on a sub-menu item activates it (the caller opens the sub-menu, which takes focus); Left or Escape inside the sub-menu reports false through Self::on_submenu_change and returns focus to the parent menu.

Implementations

impl MenuPopup

pub fn new( id: impl Into<ElementId>, trigger: impl IntoElement, menu: MaterialMenu, ) -> Self

pub fn close_on_activate(self, close: bool) -> Self

Close the menu when an item (other than a sub-menu) is activated (default). Off, the menu stays open, e.g. to toggle several items.

pub fn submenu(self, index: usize, menu: MaterialMenu, open: bool) -> Self

A cascading sub-menu for the main menu’s item at flat index (counting across groups), shown while open.

pub fn on_submenu_change( self, handler: impl Fn(&bool, &mut Window, &mut App) + 'static, ) -> Self

Left or Escape inside the open sub-menu reports false.

pub fn open(self, open: bool) -> Self

pub fn on_open_change( self, handler: impl Fn(&bool, &mut Window, &mut App) + 'static, ) -> Self

pub fn anchor(self, anchor: Anchor) -> Self

The popup’s own anchor corner (Kit’s convention; default top-left, below the trigger). LeftCenter and RightCenter place the menu beside the trigger, to its right or left, with their tops aligned (M3’s “right start” and “left start” placements).

Trait Implementations

impl IntoElement for MenuPopup

type Element = ViewElement<MenuPopup>

The specific type of element into which the implementing type is converted. Useful for converting other types into elements automatically, like Strings

fn into_element(self) -> Self::Element

Convert self into a type that implements [Element].

fn into_any_element(self) -> AnyElement

Convert self into a dynamically-typed [AnyElement].

impl RenderOnce for MenuPopup

fn render(self, window: &mut Window, cx: &mut App) -> impl IntoElement

Render this component into an element tree. Note that this method takes ownership of self, as compared to [Render::render()] method which takes a mutable reference.