maud-ui 0.1.0

58 headless, accessible UI components for Rust web apps. Built on maud + htmx, styled like shadcn/ui.
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
67

//! Kbd component — keyboard shortcut display.

use maud::{html, Markup};

/// Keyboard shortcut rendering properties
#[derive(Debug, Clone)]
pub struct Props {
    /// Keys to display (e.g., ["Ctrl", "S"] or ["⌘", "K"])
    pub keys: Vec<String>,
}

impl Default for Props {
    fn default() -> Self {
        Self {
            keys: Vec::new(),
        }
    }
}

/// Render keyboard shortcut with key separator
pub fn render(props: Props) -> Markup {
    html! {
        div.mui-kbd-container {
            @for (idx, key) in props.keys.iter().enumerate() {
                @if idx > 0 {
                    span.mui-kbd-separator { "+" }
                }
                kbd.mui-kbd { (key) }
            }
        }
    }
}

/// Showcase keyboard shortcuts in a help card context
pub fn showcase() -> Markup {
    html! {
        div.mui-showcase__grid {
            div {
                p.mui-showcase__caption { "Keyboard shortcuts" }
                div style="border:1px solid var(--mui-border);border-radius:var(--mui-radius-lg);padding:1rem;background:var(--mui-bg-card);max-width:20rem;" {
                    div style="display:flex;flex-direction:column;gap:0.625rem;" {
                        div style="display:flex;justify-content:space-between;align-items:center;" {
                            span style="font-size:0.875rem;color:var(--mui-fg-muted);" { "Save" }
                            (render(Props { keys: vec!["\u{2318}".into(), "S".into()] }))
                        }
                        div style="display:flex;justify-content:space-between;align-items:center;" {
                            span style="font-size:0.875rem;color:var(--mui-fg-muted);" { "Undo" }
                            (render(Props { keys: vec!["\u{2318}".into(), "Z".into()] }))
                        }
                        div style="display:flex;justify-content:space-between;align-items:center;" {
                            span style="font-size:0.875rem;color:var(--mui-fg-muted);" { "Redo" }
                            (render(Props { keys: vec!["\u{21E7}".into(), "\u{2318}".into(), "Z".into()] }))
                        }
                        div style="display:flex;justify-content:space-between;align-items:center;" {
                            span style="font-size:0.875rem;color:var(--mui-fg-muted);" { "Command palette" }
                            (render(Props { keys: vec!["\u{2318}".into(), "K".into()] }))
                        }
                        div style="display:flex;justify-content:space-between;align-items:center;" {
                            span style="font-size:0.875rem;color:var(--mui-fg-muted);" { "Toggle comment" }
                            (render(Props { keys: vec!["\u{2318}".into(), "/".into()] }))
                        }
                    }
                }
            }
        }
    }
}