zsui 0.3.0-alpha.2

Rust-first feature-gated native UI framework for Win32, AppKit, and Linux.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

/// Wraps a page with a target-anchored menu surface.
///
/// Applications declare one [`MenuSpec`](crate::MenuSpec) and receive its
/// typed [`Command`](crate::Command) values through `on_menu_flyout_command`.
/// ZSUI owns placement, keyboard navigation, light dismissal and the distinct
/// Windows, macOS and Linux menu metrics.
pub fn menu_flyout<Msg>(
    widget: WidgetId,
    open: bool,
    target: WidgetId,
    menu: crate::MenuSpec,
    page: ViewNode<Msg>,
) -> ViewNode<Msg> {
    let highlighted = open.then(|| {
        crate::ZsMenuFlyoutState {
            open: true,
            target,
            highlighted: None,
            open_submenus: Vec::new(),
        }
        .first_enabled(&menu)
    });
    ViewNode::new(ViewNodeKind::MenuFlyout {
        menu,
        open,
        target,
        #[cfg(feature = "context-menu")]
        context_trigger: false,
        #[cfg(feature = "context-menu")]
        context_anchor: None,
        anchor: None,
        highlighted: highlighted.flatten(),
        open_submenus: Vec::new(),
        on_command: None,
        on_open_change: None,
    })
    .id(widget)
    .child(page)
}

/// Wraps a page in a menu that opens automatically at a secondary-click point.
///
/// The page can be a table, tree, row, or blank layout surface. ZSUI owns the
/// secondary-button listener, pointer anchor, keyboard navigation, and light
/// dismissal; applications only map selected commands.
#[cfg(feature = "context-menu")]
pub fn context_menu<Msg>(
    widget: WidgetId,
    menu: crate::MenuSpec,
    page: ViewNode<Msg>,
) -> ViewNode<Msg> {
    ViewNode::new(ViewNodeKind::MenuFlyout {
        menu,
        open: false,
        target: widget,
        context_trigger: true,
        context_anchor: None,
        anchor: None,
        highlighted: None,
        open_submenus: Vec::new(),
        on_command: None,
        on_open_change: None,
    })
    .id(widget)
    .child(page)
}