ContextMenu

Attach a menu to a response in the same UI scope. Right-click opens it at the pointer. The shared popup layer handles viewport fitting, Escape, outside presses, focus restoration, and clipping independently from the target's parent.

use zaxis::{ContextMenuItem, Id};

let items = [
    ContextMenuItem::new("copy", "Copy").icon("+").right_text("Ctrl+C"),
    ContextMenuItem::separator(),
    ContextMenuItem::new("export", "Export").left_text("01").enabled(false),
];
let target = ui.button("Document");
if ui.context_menu(target, &items).selected == Some(Id::new("copy")) {
    // Perform the action once.
}

icon accepts a font glyph. icon_shapes accepts vector shapes in an 18 × 18 logical-pixel box. Icons align in a compact column; left captions precede their labels; right_text aligns to the trailing edge. Action IDs must be unique and remain stable when labels or item order change. Duplicate visible labels are supported. Shortcut captions are display text; shortcut handling belongs to the application.

In one expression, ui.add(Button::new("Document").context_menu(&items)) attaches the menu to the widget and reports the choice as response.menu_selected(). The menu opens on the same Response::secondary_clicked() signal that any control reports: a secondary press and release over the same target.

Use ContextMenu::new(source, &items).style(style).show(ui, target) for custom proportions and popup/control appearances. open_at(position) opens on that pass; omit it on following passes to retain the menu. ContextMenuOutput reports the open state, popup rectangle, and selected action ID.

Arrow keys skip separators and disabled items. Home/End select the first/last enabled action; Enter/Space activate it. Long menus scroll automatically when keyboard selection moves outside the viewport. Passive text responses can also have a menu without changing their primary-click behavior.

Hover and keyboard highlighting update immediately, without a tween. Unchanged item measurements are retained; long menus build only rows that intersect the viewport, including menus with mixed action and separator heights.

The release CPU stress benchmark covers idle, hover, keyboard navigation, and scrolling with 10, 100, 1,000, and 10,000 items:

cargo bench --bench context_menu -- --iterations 1000 --output target/context-menu-benchmark.json

cargo run --example context_menu

AccessibilityCopy Anchor Link

A widget with a context menu accepts ShowContextMenu; the menu opens at the middle of the visible part of the widget. The open menu is a Menu of MenuItem rows (MenuItemCheckBox for a checked row). A row is named by its text, carries its shortcut caption as a keyboard shortcut, and accepts Click; a row with a submenu also accepts Expand and Collapse. The highlighted row is the active descendant of the menu. See Accessibility.