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

pub struct Item {
    pub(super) value: String,
    pub(super) count: u32,
    pub(super) left_char_offset: u32,
    pub(super) left: u32,
    pub(super) checked: bool,
    pub(super) filtered: bool
}

impl Item {
    /// Creates a new item with the specified text and checked state. 
    /// 
    /// # Example
    /// ```rust, no_run
    /// use appcui::ui::listbox::Item;
    /// let item = Item::new("Item 1", false);
    /// ```
    pub fn new(text: &str, checked: bool) -> Self {
        Item {
            value: String::from(text),
            count: text.chars().count() as u32,
            left: 0,
            left_char_offset: 0,
            checked,
            filtered: true
        }
    }

    /// Returns the text of the item.
    #[inline(always)]
    pub fn text(&self) -> &str {
        &self.value
    }

    /// Returns true if the item is checked or false otherwise.
    #[inline(always)]
    pub fn is_checked(&self) -> bool {
        self.checked
    }
    #[inline(always)]
    pub(super) fn visible_text(&self) -> &str {
        if self.left_char_offset >= self.value.len() as u32 {
            ""
        } else {
            &self.value[self.left_char_offset as usize..]
        }
    }
    pub(super) fn update_left_pos(&mut self, new_left: u32) {
        if new_left != self.left {
            self.left = new_left;
            if new_left == 0 {
                self.left_char_offset = 0;
            } else if new_left > self.count {
                self.left_char_offset = u32::MAX;
            } else if let Some(offset) = self.value.char_indices().nth(new_left as usize).map(|(offset, _)| offset) {
                self.left_char_offset = offset as u32;
            } else {
                self.left_char_offset = u32::MAX;
            }
        }
    }
}