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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

use yew::prelude::*;
use crate::util::{Color, TextColor};
use crate::component::card::CardBody;

/// # Properties of [Card]
#[derive(Properties, Clone, PartialEq)]
pub struct CardProps {
    /// Inner components (displayed in the [Card])
    #[prop_or_default]
    pub children: Children,
    /// Extra CSS classes to include, in addition to the defaults.
    #[prop_or_default]
    pub class: Classes,
    /// Color style.
    #[prop_or_default]
    pub bg: Option<Color>,
    /// Text color style.
    #[prop_or_default]
    pub text: Option<TextColor>,
    /// Border color style.
    #[prop_or_default]
    pub border: Option<Color>,
    /// If true, implicitly wraps children in a [CardBody].
    #[prop_or_default]
    pub body: bool,
}

/// # Card component
/// Container for a Card, a component generally used for dynamic display of items in a grid pattern.
/// Takes any item as child, but most often [body](super::body) items, [image](super::image) items,
/// or a flush [ListGroup](crate::component::ListGroup).
///
/// See [CardProps] for a list of properties.
///
/// ## Examples
///
/// With header and footer text:
/// ```
/// use yew::prelude::*;
/// use yew_bootstrap::component::card::*;
/// fn test() -> Html {
///   html! {
///     <Card>
///         <CardHeader>{"Card Head"}</CardHeader>
///         <CardBody>{"Body text"}</CardBody>
///         <CardFooter>{"Card Foot"}</CardFooter>
///     </Card>
///   }
/// }
/// ```
///
/// With a top image and image description, instead:
/// ```
/// use yew::prelude::*;
/// use yew_bootstrap::component::card::*;
/// fn test() -> Html {
///   html! {
///     <Card>
///         <CardImage variant={ImageVariant::Top} src="imgsrc.jpg"/>
///         <CardBody>{"Image description"}</CardBody>
///     </Card>
///   }
/// }
/// ```
///
/// Setting the `body` property, everything is implicitly wrapped in a [CardBody]:
/// ```
/// use yew::prelude::*;
/// use yew_bootstrap::component::card::*;
/// fn test() -> Html {
///   html! {
///     <Card body=true>
///         {"Body text, great for simple cards"}
///     </Card>
///   }
/// }
/// ```
#[function_component]
pub fn Card(props: &CardProps) -> Html {
    let mut classes = props.class.clone();
    classes.push("card");
    if let Some(color) = &props.bg {
        classes.push(format!("bg-{}", color));
    }
    if let Some(color) = &props.text {
        classes.push(format!("text-{}", color));
    }
    if let Some(color) = &props.border {
        classes.push(format!("border-{}", color));
    }

    html! {
        <div class={classes}>
            if props.body {
                <CardBody>{ props.children.clone() }</CardBody>
            } else {
                { props.children.clone() }
            }
        </div>
    }
}