tuika 0.7.0

The application framework for Rust terminal UIs — flexbox layout, overlays, focus, keymap, components, and safe ratatui interoperability.
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

//! Width-driven view selection for responsive terminal layouts.

use ratatui_core::layout::Rect;

use crate::{Element, RenderCtx, Size, Surface, View};

/// Select between compact and wide layouts at a column breakpoint.
///
/// Each branch is a normal view tree, so an application can switch from a row
/// to a column, omit secondary content, or choose a shorter status component
/// without embedding breakpoint logic in individual leaves.
pub struct Responsive<V: View = Element> {
    breakpoint: u16,
    compact: V,
    wide: V,
}

impl<V: View> Responsive<V> {
    /// Use `compact` below `breakpoint` columns and `wide` otherwise.
    pub fn new(breakpoint: u16, compact: V, wide: V) -> Self {
        Self {
            breakpoint,
            compact,
            wide,
        }
    }

    fn select(&self, width: u16) -> &V {
        if width < self.breakpoint {
            &self.compact
        } else {
            &self.wide
        }
    }
}

impl<V: View> View for Responsive<V> {
    fn measure(&self, available: Size, ctx: &RenderCtx) -> Size {
        self.select(available.width).measure(available, ctx)
    }

    fn render(&self, area: Rect, surface: &mut Surface, ctx: &RenderCtx) {
        self.select(area.width).render(area, surface, ctx);
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::components::Text;
    use crate::style::Theme;
    use crate::tests::support::row;
    use crate::view::element;

    #[test]
    fn responsive_selects_layout_from_render_width() {
        let view = Responsive::new(
            10,
            element(Text::raw("compact")),
            element(Text::raw("wide")),
        );
        let theme = Theme::default();
        let compact = crate::testing::render(&view, 8, 1, &theme);
        let wide = crate::testing::render(&view, 12, 1, &theme);
        assert_eq!(row(&compact, 0), "compact");
        assert_eq!(row(&wide, 0), "wide");
    }
}