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

//! A horizontal progress gauge: an accent bar with a centered percentage label.
//!
//! The bar segment that sits behind the label is drawn in `accent_dark` so the
//! text stays readable over the fill.

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

use super::style;
use crate::theme::Palette;

/// Renders a gauge filled to `ratio` (clamped to `0.0..=1.0`) on the first row
/// of `area`, with `label` centered over the bar.
pub fn render(
    frame: &mut Frame,
    area: Rect,
    palette: &Palette,
    ratio: f64,
    label: &str,
) {
    let width = area.width as usize;
    if width == 0 {
        return;
    }
    let filled = (ratio.clamp(0.0, 1.0) * width as f64).round() as usize;
    let label_chars: Vec<char> = label.chars().collect();
    let label_start = width.saturating_sub(label_chars.len()) / 2;

    let accent = style::to_ratatui(palette.accent);
    let accent_dark = style::to_ratatui(palette.accent_dark);
    let track = style::to_ratatui(palette.selection_bg);

    let spans: Vec<Span> = (0..width)
        .map(|index| {
            let filled_here = index < filled;
            let label_char = index
                .checked_sub(label_start)
                .and_then(|offset| label_chars.get(offset));
            if let Some(&ch) = label_char {
                // Over the filled bar the text turns dark for contrast; over
                // the track it stays in the accent color. The background is
                // always the underlying bar/track.
                let (foreground, background) = if filled_here {
                    (accent_dark, accent)
                } else {
                    (accent, track)
                };
                Span::styled(
                    ch.to_string(),
                    Style::default()
                        .fg(foreground)
                        .bg(background)
                        .add_modifier(Modifier::BOLD),
                )
            } else {
                let background = if filled_here { accent } else { track };
                Span::styled(" ".to_string(), Style::default().bg(background))
            }
        })
        .collect();

    frame.render_widget(Paragraph::new(Line::from(spans)), area);
}