appcui 0.4.8

A feature-rich and cross-platform TUI/CUI framework for Rust, enabling modern terminal-based applications on Windows, Linux, and macOS. Includes built-in UI components like buttons, menus, list views, tree views, checkboxes, and more. Perfect for building fast and interactive CLI tools and text-based interfaces.
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
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

use crate::{
    graphics::{Character, Point, Rect, Size, SpecialChar, Surface, TextAlignment, WrapType},
    prelude::TextFormatBuilder,
};

use super::Theme;

pub(crate) struct ToolTip {
    visible: bool,
    text_pos: Point,
    arrow_pos: Point,
    arrow_char: SpecialChar,
    canvas: Surface,
}
impl ToolTip {
    pub(crate) fn new() -> Self {
        ToolTip {
            visible: false,
            text_pos: Point::default(),
            arrow_pos: Point::default(),
            arrow_char: SpecialChar::ArrowDown,
            canvas: Surface::new(16, 16),
        }
    }
    #[inline(always)]
    pub(crate) fn is_visible(&self) -> bool {
        self.visible
    }
    pub(crate) fn show(&mut self, text: &str, object_rect: &Rect, screen_size: Size, theme: &Theme) -> bool {
        self.visible = false;

        let mut nr_lines = 0u32;
        let max_width = screen_size.width / 2;
        let mut w = 0u32;
        let mut best_width = 0u32;
        let mut chars_count = 0usize;
        for c in text.chars() {
            chars_count += 1;
            if (c == '\n') || (c == '\r') {
                best_width = best_width.max(w);
                w = 0;
                nr_lines += 1;
                continue;
            }
            w += 1;
            if w > max_width {
                best_width = max_width;
                w = 1; // the extra character is moved to the next line
                nr_lines += 1;
            }
        }
        if w > 0 {
            best_width = best_width.max(w);
            nr_lines += 1;
        }
        nr_lines = nr_lines.min(screen_size.height / 3).max(1);
        best_width = best_width.max(5) + 2;

        // find best position  (prefer on-top)
        if object_rect.top() >= ((nr_lines + 1) as i32) {
            let cx = object_rect.center_x();
            let mut x = cx - ((best_width / 2) as i32);
            let top = object_rect.top();
            //let best_x = x;
            x = x.min((screen_size.width as i32) - (best_width as i32)).max(0);
            self.arrow_pos = Point::new(cx.clamp(0, (screen_size.width as i32) - 1), top - 1);
            self.arrow_char = SpecialChar::ArrowDown;
            self.text_pos = Point::new(x, top - ((nr_lines + 1) as i32));
            let format = TextFormatBuilder::new()
                .position(1, 0)
                .attribute(theme.tooltip.text)
                .align(TextAlignment::Left)
                .chars_count(chars_count as u16)
                .wrap_type(WrapType::WordWrap((best_width - 2) as u16))
                .build();
            self.canvas.resize(Size::new(best_width, nr_lines));
            self.canvas.clear(Character::with_attributes(' ', theme.tooltip.text));
            self.canvas.write_text(text, &format);
            self.visible = true;
            return true;
        }
        // bottom position
        if (object_rect.bottom() + ((nr_lines + 1) as i32)) <= screen_size.height as i32 {
            let cx = object_rect.center_x();
            let mut x = cx - ((best_width / 2) as i32);
            let bottom = object_rect.bottom();
            //let best_x = x;
            x = x.min((screen_size.width as i32) - (best_width as i32)).max(0);
            self.arrow_pos = Point::new(cx.clamp(0, (screen_size.width as i32) - 1), bottom + 1);
            self.arrow_char = SpecialChar::ArrowUp;
            self.text_pos = Point::new(x, bottom + 2);
            let format = TextFormatBuilder::new()
                .position(1, 0)
                .attribute(theme.tooltip.text)
                .align(TextAlignment::Left)
                .chars_count(chars_count as u16)
                .wrap_type(WrapType::WordWrap((best_width - 2) as u16))
                .build();
            self.canvas.resize(Size::new(best_width, nr_lines));
            self.canvas.clear(Character::with_attributes(' ', theme.tooltip.text));
            self.canvas.write_text(text, &format);
            self.visible = true;
        }
        false
    }
    pub(crate) fn hide(&mut self) {
        self.visible = false;
    }
    pub(crate) fn paint(&self, surface: &mut Surface, theme: &Theme) {
        if !self.visible {
            return;
        }
        surface.draw_surface(self.text_pos.x, self.text_pos.y, &self.canvas);
        surface.write_char(
            self.arrow_pos.x,
            self.arrow_pos.y,
            Character::with_attributes(self.arrow_char, theme.tooltip.arrow),
        );
    }
}