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

/// Creates a noninteractive standalone semantic icon.
///
/// The application chooses only the semantic symbol, size role and color
/// role. Each desktop renderer resolves the actual WinUI glyph, SF Symbol or
/// Linux symbolic icon and the platform profile owns its logical dimensions.
pub fn icon<Msg>(icon: crate::ZsIcon) -> ViewNode<Msg> {
    ViewNode::new(ViewNodeKind::Icon {
        icon,
        size: crate::ZsIconSize::Standard,
        color: ColorRole::PrimaryText,
    })
    .flex(0.0)
}

impl<Msg> ViewNode<Msg> {
    /// Selects a semantic icon size without exposing target pixel constants.
    pub fn icon_size(mut self, size: crate::ZsIconSize) -> Self {
        if let ViewNodeKind::Icon { size: current, .. } = &mut self.kind {
            *current = size;
            self.icon_role = None;
        }
        self
    }

    /// Uses the platform's glyph metric for a semantic placement role.
    pub fn icon_role(mut self, role: crate::ZsIconRole) -> Self {
        if matches!(self.kind, ViewNodeKind::Icon { .. }) { self.icon_role = Some(role); }
        self
    }

    /// Selects a theme-aware semantic color for a standalone icon.
    pub fn icon_color(mut self, color: ColorRole) -> Self {
        if let ViewNodeKind::Icon { color: current, .. } = &mut self.kind {
            *current = color;
        }
        self
    }
}