orbital-core-components 0.1.1

Themed Orbital UI components for Leptos applications
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
86
87
88
89
90
91
92

use leptos::prelude::*;
use orbital_macros::component_doc;

use super::styles::card_content_styles;

/// Body content region inside a card with default horizontal and bottom padding.
///
/// Use between header or media slots and the footer for primary copy. Override padding via Turf `class` setting `--orbital-card-content-padding`.
///
/// # Examples
///
/// ## Default body
/// Standalone body copy inside a card surface.
/// <!-- default -->
/// <!-- preview -->
/// ```rust
/// use crate::{Card, CardContent};
/// use turf::inline_style_sheet_values;
/// view! {
///     <div data-testid="card-content-preview">
///         <div data-testid="card-content-default" style="max-width: 360px;">
///             {
///                 let (style_sheet, class_names) = inline_style_sheet_values! {
///                     .PaddedContent {
///                         --orbital-card-content-padding: 16px;
///                     }
///                 };
///                 view! {
///                     <style>{style_sheet}</style>
///                     <Card>
///                         <CardContent class=class_names.padded_content>
///                             "Card body copy."
///                         </CardContent>
///                     </Card>
///                 }
///             }
///         </div>
///     </div>
/// }
/// ```
///
/// ## Stacked below media
/// Body region below a media hero and above footer actions.
/// <!-- preview -->
/// ```rust
/// use crate::{Card, CardContent, CardFooter, CardMedia, Button};
/// view! {
///     <div data-testid="card-content-stacked" style="max-width: 360px;">
///         <Card>
///             <CardMedia
///                 src="https://picsum.photos/seed/orbital-card/360/140"
///                 alt="Sample card illustration"
///             />
///             <CardContent>"Body below the hero image."</CardContent>
///             <CardFooter>
///                 <Button>"Action"</Button>
///             </CardFooter>
///         </Card>
///     </div>
/// }
/// ```
#[component_doc(
    category = "Surfaces",
    preview_slug = "card-content",
    preview_label = "Card Content",
    preview_icon = icondata::AiLayoutOutlined,
)]
#[component]
pub fn CardContent(
    /// Extra CSS class names merged onto the body region. Override padding via Turf class setting `--orbital-card-content-padding`.
    #[prop(optional, into)]
    class: MaybeProp<String>,
    /// Primary card body copy and nested content between header or media slots and the footer.
    children: Children,
) -> impl IntoView {
    let style_sheet = card_content_styles();
    let root_class = Memo::new(move |_| {
        let extra = class.get().unwrap_or_default();
        if extra.is_empty() {
            "orbital-card-content".to_string()
        } else {
            format!("orbital-card-content {extra}")
        }
    });

    view! {
        <style>{style_sheet}</style>
        <div class=root_class>
            {children()}
        </div>
    }
}