ratada 0.0.1

A ratatui widget toolkit: driver, modals, forms, pickers, theming
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

//! A selectable, vertically scrollable list with a scrollbar.

use std::cell::Cell;

use ratatui::{
    Frame, layout::Rect, style::Modifier, text::Line, widgets::Paragraph,
};

use super::{chrome, nav, scroll, style};
use crate::theme::Skin;

/// Renders `rows` in `area`, highlighting the `selected` row and scrolling to
/// keep it visible. `offset` persists the scroll position across frames.
///
/// Callers build each row's content (and any per-row styling such as dimming);
/// this widget overlays the selection highlight and the scrollbar. The
/// highlight follows the [`Mode`](crate::theme::Mode): `Minimal` uses a subtle
/// `selection_bg` tint, `Fancy` a bold accent-tinted bar.
pub fn render(
    frame: &mut Frame,
    area: Rect,
    skin: &Skin,
    rows: Vec<Line<'static>>,
    selected: usize,
    offset: &Cell<usize>,
) {
    let viewport = area.height as usize;
    let total = rows.len();
    let visible_offset =
        nav::keep_visible(offset.get(), selected, viewport, total);
    offset.set(visible_offset);

    let highlight = if skin.is_fancy() {
        style::bg(skin.palette.accent_dark)
            .fg(style::to_ratatui(skin.palette.accent))
            .add_modifier(Modifier::BOLD)
    } else {
        style::bg(skin.palette.selection_bg)
    };

    let visible: Vec<Line> = rows
        .into_iter()
        .enumerate()
        .skip(visible_offset)
        .take(viewport)
        .map(|(index, line)| {
            if index == selected {
                line.style(highlight)
            } else {
                line
            }
        })
        .collect();

    frame.render_widget(Paragraph::new(visible), area);
    scroll::render_scrollbar(frame, area, total, visible_offset, viewport);
}

/// Like [`render`], but wrapped in a rounded box (see [`chrome::BoxDecor`]) when
/// in `Fancy` mode or when `force` is set. The badge defaults to the row count.
#[allow(clippy::too_many_arguments)]
pub fn render_boxed(
    frame: &mut Frame,
    area: Rect,
    skin: &Skin,
    rows: Vec<Line<'static>>,
    selected: usize,
    offset: &Cell<usize>,
    decor: &chrome::BoxDecor,
    force: bool,
) {
    let inner = if force || skin.is_fancy() {
        chrome::framed_decor(frame, area, skin, decor, &rows.len().to_string())
    } else {
        area
    };
    render(frame, inner, skin, rows, selected, offset);
}