iocraft 0.8.1

Create beautifully crafted CLI programs and text output with a declarative React-like Rust API.
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
86

use crate::{AnyElement, Component, ComponentUpdater, Hooks, Props};

/// The props which can be passed to the [`Fragment`] component.
#[non_exhaustive]
#[derive(Default, Props)]
pub struct FragmentProps<'a> {
    /// The children of the component.
    pub children: Vec<AnyElement<'a>>,
}

/// `Fragment` is a component which allows you to group elements without impacting the resulting
/// layout.
///
/// This is typically used when you want to create a component that returns multiple elements.
///
/// # Example
///
/// ```
/// # use iocraft::prelude::*;
/// #[component]
/// fn TextLines() -> impl Into<AnyElement<'static>> {
///     element! {
///         Fragment {
///             Text(content: "Line 1")
///             Text(content: "Line 2")
///         }
///     }
/// }
///
/// fn MyComponent() -> impl Into<AnyElement<'static>> {
///     element! {
///         View(flex_direction: FlexDirection::Column) {
///             TextLines
///         }
///     }
/// }
/// ```
#[derive(Default)]
pub struct Fragment;

impl Component for Fragment {
    type Props<'a> = FragmentProps<'a>;

    fn new(_props: &Self::Props<'_>) -> Self {
        Self
    }

    fn update(
        &mut self,
        props: &mut Self::Props<'_>,
        _hooks: Hooks,
        updater: &mut ComponentUpdater,
    ) {
        updater.set_transparent_layout(true);
        updater.update_children(props.children.iter_mut(), None);
    }
}

#[cfg(test)]
mod tests {
    use crate::prelude::*;

    #[component]
    fn TextLines() -> impl Into<AnyElement<'static>> {
        element! {
            Fragment {
                Text(content: "Line 1")
                Text(content: "Line 2")
            }
        }
    }

    #[component]
    fn MyComponent() -> impl Into<AnyElement<'static>> {
        element! {
            View(flex_direction: FlexDirection::Column) {
                TextLines
            }
        }
    }

    #[test]
    fn test_fragment() {
        assert_eq!(element!(MyComponent).to_string(), "Line 1\nLine 2\n");
    }
}