cranpose-ui 0.9.0

UI primitives for Cranpose
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 super::{DimensionConstraint, Modifier, inspector_metadata};
use crate::modifier_nodes::FillElement;

thread_local! {
    static FILL_WIDTH: Modifier = Modifier::with_element(FillElement::width(1.0));
    static FILL_HEIGHT: Modifier = Modifier::with_element(FillElement::height(1.0));
    static FILL_SIZE: Modifier = Modifier::with_element(FillElement::size(1.0));
}

fn fill_modifier(
    fraction: f32,
    full: &'static std::thread::LocalKey<Modifier>,
    element: fn(f32) -> FillElement,
) -> Modifier {
    if fraction == 1.0 {
        full.with(Clone::clone)
    } else {
        Modifier::with_element(element(fraction))
    }
}

impl Modifier {
    /// Have the content fill the maximum available width.
    ///
    /// The `fraction` parameter allows filling only a portion of the available width (0.0 to 1.0).
    ///
    /// Matches Kotlin: `Modifier.fillMaxWidth(fraction: Float)`
    ///
    /// Example: `Modifier::empty().fill_max_width()`
    pub fn fill_max_width(self) -> Self {
        self.fill_max_width_fraction(1.0)
    }

    /// Fill a fraction of the maximum available width.
    ///
    /// Example: `Modifier::empty().fill_max_width_fraction(0.5)`
    pub fn fill_max_width_fraction(self, fraction: f32) -> Self {
        let clamped = fraction.clamp(0.0, 1.0);
        let modifier = fill_modifier(clamped, &FILL_WIDTH, FillElement::width)
            .with_inspector_metadata(inspector_metadata("fillMaxWidth", move |info| {
                info.add_dimension("width", DimensionConstraint::Fraction(clamped));
            }));
        self.then(modifier)
    }

    /// Have the content fill the maximum available height.
    ///
    /// The `fraction` parameter allows filling only a portion of the available height (0.0 to 1.0).
    ///
    /// Matches Kotlin: `Modifier.fillMaxHeight(fraction: Float)`
    ///
    /// Example: `Modifier::empty().fill_max_height()`
    pub fn fill_max_height(self) -> Self {
        self.fill_max_height_fraction(1.0)
    }

    /// Fill a fraction of the maximum available height.
    ///
    /// Example: `Modifier::empty().fill_max_height_fraction(0.5)`
    pub fn fill_max_height_fraction(self, fraction: f32) -> Self {
        let clamped = fraction.clamp(0.0, 1.0);
        let modifier = fill_modifier(clamped, &FILL_HEIGHT, FillElement::height)
            .with_inspector_metadata(inspector_metadata("fillMaxHeight", move |info| {
                info.add_dimension("height", DimensionConstraint::Fraction(clamped));
            }));
        self.then(modifier)
    }

    /// Have the content fill the maximum available size (both width and height).
    ///
    /// The `fraction` parameter allows filling only a portion of the available size (0.0 to 1.0).
    ///
    /// Matches Kotlin: `Modifier.fillMaxSize(fraction: Float)`
    ///
    /// Example: `Modifier::empty().fill_max_size()`
    pub fn fill_max_size(self) -> Self {
        self.fill_max_size_fraction(1.0)
    }

    /// Fill a fraction of the maximum available size.
    ///
    /// Example: `Modifier::empty().fill_max_size_fraction(0.8)`
    pub fn fill_max_size_fraction(self, fraction: f32) -> Self {
        let clamped = fraction.clamp(0.0, 1.0);
        let modifier = fill_modifier(clamped, &FILL_SIZE, FillElement::size)
            .with_inspector_metadata(inspector_metadata("fillMaxSize", move |info| {
                info.add_dimension("width", DimensionConstraint::Fraction(clamped));
                info.add_dimension("height", DimensionConstraint::Fraction(clamped));
            }));
        self.then(modifier)
    }
}