euv-ui 0.32.9

Reusable UI component library for the euv framework, providing buttons, cards, modals, inputs, and more.
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

use super::*;

/// A generic documentation page layout aligned with common site frameworks
/// (VuePress default theme `Page`, Docusaurus doc item): a fluid content
/// column with the page body as children, `euv_pagination` prev/next links
/// and an optional footer, plus a sticky right `euv_toc` anchor column that
/// collapses on narrow viewports.
///
/// # Arguments
///
/// - `VirtualNode<EuvDocLayoutProps>` - The props node.
///
/// # Returns
///
/// - `VirtualNode` - The doc page layout virtual DOM tree.
#[component]
pub fn euv_doc_layout(node: VirtualNode<EuvDocLayoutProps>) -> VirtualNode {
    let EuvDocLayoutProps {
        toc_title,
        toc_items,
        prev_label,
        next_label,
        prev,
        next,
        footer,
        footer_link,
        footer_items,
        toc_active,
    }: EuvDocLayoutProps = node.try_get_props().unwrap_or_default();
    let children: VirtualNode = node.get_children().into();
    html! {
        div {
            class: c_euv_doc_layout()
            div {
                class: c_euv_doc_content()
                // Exactly two flex children, so `justify-content:
                // space-between` has two ends to distribute between:
                //   1. the page body — the `<h1>` title and the rendered
                //      markdown, grouped in one wrapper so they travel
                //      together and the title is never separated from the
                //      first paragraph;
                //   2. `c_euv_doc_tail` — pagination plus footer.
                // When the body is short the tail drops to the bottom of
                // the scroll area; when the body is taller the column
                // grows and the tail follows in normal flow.
                // The body wrapper must be a real element (not a
                // `display: contents` slot): a transparent slot hoists
                // the title and the article into the column as separate
                // flex items, which makes `space-between` distribute the
                // free space *between the title and the first paragraph*
                // — that is what opened a large gap under the title.
                div {
                    class: c_euv_doc_body()
                    children
                }
                div {
                    class: c_euv_doc_tail()
                    euv_pagination {
                        prev_label
                        next_label
                        prev
                        next
                    }
                    if { !footer.is_empty() || !footer_items.is_empty() } {
                        euv_footer {
                            text: footer
                            link: footer_link
                            items: footer_items
                        }
                    }
                }
            }
            if { !toc_items.is_empty() } {
                div {
                    class: c_euv_doc_toc()
                    euv_toc {
                        title: toc_title
                        items: toc_items
                        active: toc_active
                    }
                }
            }
        }
    }
}