lv-tui 0.4.0

A reactive TUI framework for Rust
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

use crate::component::{Component, EventCx, LayoutCx, MeasureCx};
use crate::event::Event;
use crate::geom::{Rect, Size};
use crate::layout::Constraint;
use crate::node::Node;
use crate::render::RenderCx;
use crate::style::{Layout, Style};

/// 层叠容器 widget——子组件共享同一区域，按添加顺序自底向上渲染
pub struct Stack {
    children: Vec<Node>,
    style: Style,
}

impl Stack {
    pub fn new() -> Self {
        Self {
            children: Vec::new(),
            style: Style::default().layout(Layout::Horizontal),
        }
    }

    pub fn child(mut self, component: impl Component + 'static) -> Self {
        self.children.push(Node::new(component));
        self
    }

    pub fn padding(mut self, value: u16) -> Self {
        self.style = self.style.padding(value);
        self
    }
}

impl Component for Stack {
    fn render(&self, cx: &mut RenderCx) {
        for child in &self.children {
            child.render_with_parent(cx.buffer, cx.focused_id, cx.clip_rect, cx.wrap, cx.truncate, cx.align, Some(&cx.style));
        }
    }

    fn for_each_child(&self, f: &mut dyn FnMut(&Node)) {
        for child in &self.children {
            f(child);
        }
    }

    fn for_each_child_mut(&mut self, f: &mut dyn FnMut(&mut Node)) {
        for child in &mut self.children {
            f(child);
        }
    }

    fn measure(&self, constraint: Constraint, _cx: &mut MeasureCx) -> Size {
        let mut max_w: u16 = 0;
        let mut max_h: u16 = 0;
        for child in &self.children {
            let s = child.measure(constraint);
            max_w = max_w.max(s.width);
            max_h = max_h.max(s.height);
        }
        Size {
            width: max_w.saturating_add(self.style.padding.left).saturating_add(self.style.padding.right),
            height: max_h.saturating_add(self.style.padding.top).saturating_add(self.style.padding.bottom),
        }
    }

    fn focusable(&self) -> bool {
        false
    }


    fn event(&mut self, event: &Event, cx: &mut EventCx) {
        if matches!(event, Event::Focus | Event::Blur | Event::Tick) {
            return;
        }

        // 从上到下分发（后添加的在上层，优先处理）
        for child in self.children.iter_mut().rev() {
            let mut child_cx =
                EventCx::with_task_sender(&mut child.dirty, cx.global_dirty, cx.quit, cx.phase, cx.propagation_stopped, cx.task_sender.clone());
            child.component.event(event, &mut child_cx);
        }
    }

    fn layout(&mut self, rect: Rect, _cx: &mut LayoutCx) {
        let inner = rect.inner(self.style.padding);
        for child in &mut self.children {
            child.layout(inner);
        }
    }

    fn style(&self) -> Style {
        self.style.clone()
    }
}