repose-material 0.28.0

Material components for Repose
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
93
94
95
96
97
98
99
100
101
102
103
104
105

#![allow(non_snake_case)]

use std::rc::Rc;

use repose_core::*;
use repose_ui::{Box, TextStyle, ViewExt};

use super::util::{apply_m3_clickable, apply_tonal_elevation};
use super::*;

/// Configuration for [`Surface`].
#[derive(Clone, Debug)]
pub struct SurfaceConfig {
    pub modifier: Modifier,
    pub enabled: bool,
    pub color: Color,
    pub content_color: Color,
    pub shape_radius: f32,
    pub tonal_elevation: f32,
    pub shadow_elevation: f32,
    pub border: Option<(f32, Color)>,
    pub interaction_source: Option<MutableInteractionSource>,
}

impl Default for SurfaceConfig {
    fn default() -> Self {
        Self {
            modifier: Modifier::new(),
            enabled: true,
            color: SurfaceDefaults::color(),
            content_color: SurfaceDefaults::content_color(),
            shape_radius: SurfaceDefaults::SHAPE_RADIUS,
            tonal_elevation: SurfaceDefaults::TONAL_ELEVATION,
            shadow_elevation: SurfaceDefaults::SHADOW_ELEVATION,
            border: None,
            interaction_source: None,
        }
    }
}

/// M3 Surface - a basic container with shape, color, elevation, and border.
/// Sets the ContentColor local for children based on the surface color.
pub fn Surface(config: SurfaceConfig, content: impl FnOnce() -> View) -> View {
    let sf_source: Rc<MutableInteractionSource> = config
        .interaction_source
        .clone()
        .map(Rc::new)
        .unwrap_or_else(|| remember(MutableInteractionSource::new));
    let mut m = Modifier::new().background(config.color);
    m = apply_tonal_elevation(m, config.tonal_elevation, config.color);
    m = m
        .clip_rounded(config.shape_radius)
        .interaction_source(&sf_source)
        .then(config.modifier);
    if config.shadow_elevation > 0.0 {
        m = m.shadow(config.shadow_elevation, 0.0);
    }
    if let Some((w, c)) = config.border {
        m = m.border(w, c, config.shape_radius);
    }
    if !config.enabled {
        m = m.enabled(false);
    }
    Box(m)
        .color(config.content_color)
        .child(with_content_color(config.content_color, content))
}

/// M3 Clickable Surface - Compose `Surface(onClick = ...)` equivalent.
pub fn ClickableSurface(
    on_click: impl Fn() + 'static,
    config: SurfaceConfig,
    content: impl FnOnce() -> View,
) -> View {
    let sf_source: Rc<MutableInteractionSource> = config
        .interaction_source
        .clone()
        .map(Rc::new)
        .unwrap_or_else(|| remember(MutableInteractionSource::new));
    let mut m = Modifier::new()
        .min_width(48.0)
        .min_height(48.0)
        .background(config.color);
    m = apply_tonal_elevation(m, config.tonal_elevation, config.color);
    m = m
        .clip_rounded(config.shape_radius)
        .interaction_source(&sf_source)
        .then(config.modifier);
    if config.shadow_elevation > 0.0 {
        m = m.shadow(config.shadow_elevation, 0.0);
    }
    if let Some((w, c)) = config.border {
        m = m.border(w, c, config.shape_radius);
    }
    m = apply_m3_clickable(
        m,
        &sf_source,
        config.content_color,
        config.enabled,
        on_click,
    );
    Box(m)
        .color(config.content_color)
        .child(with_content_color(config.content_color, content))
}