hydrolysis-m3 0.3.0

Material 3 widget theme for WaterUI self-drawn backends
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

//! Material Design 3 menu convenience API.

use waterui::component::{IntoLabel, Label};
use waterui::widget::Divider;
use waterui_controls::menu::{Command, CommandBuilder, Menu, MenuItem, MenuView};

/// A Material Design 3 menu trigger and popup menu.
pub type MaterialMenu = Menu;

/// A Material Design 3 menu item.
pub type MaterialMenuItem = MenuItem;

/// A Material Design 3 menu command.
pub type MaterialMenuCommand = Command;

/// Builder for a Material Design 3 menu command.
pub type MaterialMenuItemBuilder = CommandBuilder;

/// Creates a Material Design 3 menu.
#[must_use]
pub fn material_menu(label: impl IntoLabel, items: impl MenuView) -> MaterialMenu {
    Menu::new(label, items)
}

/// Creates a Material Design 3 menu command builder.
#[must_use]
pub fn material_menu_item(label: impl IntoLabel) -> MaterialMenuItemBuilder {
    Command::builder(label)
}

/// Creates a Material Design 3 submenu.
#[must_use]
pub fn material_sub_menu(label: impl IntoLabel, items: impl MenuView) -> MaterialMenu {
    Menu::new(label, items)
}

/// Creates a Material Design 3 menu divider.
pub const fn material_menu_divider() -> Divider {
    Divider
}

/// Creates an icon-only Material Design 3 menu trigger label.
#[must_use]
pub fn material_menu_icon_label(label: impl Into<Label>) -> Label {
    label.into().icon_only()
}

#[cfg(test)]
mod tests {
    use crate::layout::menu::text_context_metrics;

    #[test]
    fn material_menu_tokens_match_compose_menu_tokens() {
        let metrics = text_context_metrics();

        assert_eq!(metrics.row_height, 48.0);
        assert_eq!(metrics.min_width, 112.0);
        assert_eq!(metrics.max_width, 280.0);
        assert_eq!(metrics.corner_radius, 4.0);
        assert_eq!(metrics.separator_thickness, 1.0);
    }
}