mirror of
https://github.com/ratatui/ratatui.git
synced 2025-09-28 05:21:23 +00:00
8d60e96b2b
Crossterm 0.29 introduced methods to easily check / extract the event type. E.g. as_key_press_event() and is_key_press(). This commit updates the examples to use these methods instead of matching on the event type. This makes the code cleaner and easier to read. Also does a general cleanup of the event handling code in the examples.
104 lines
3.9 KiB
Rust
104 lines
3.9 KiB
Rust
//! # [Ratatui] `Table` example
|
|
//!
|
|
//! The latest version of this example is available in the [widget examples] folder in the
|
|
//! repository.
|
|
//!
|
|
//! Please note that the examples are designed to be run against the `main` branch of the Github
|
|
//! repository. This means that you may not be able to compile with the latest release version on
|
|
//! crates.io, or the one that you have installed locally.
|
|
//!
|
|
//! See the [examples readme] for more information on finding examples that match the version of the
|
|
//! library you are using.
|
|
//!
|
|
//! [Ratatui]: https://github.com/ratatui/ratatui
|
|
//! [widget examples]: https://github.com/ratatui/ratatui/blob/main/ratatui-widgets/examples
|
|
//! [examples readme]: https://github.com/ratatui/ratatui/blob/main/examples/README.md
|
|
|
|
use color_eyre::Result;
|
|
use crossterm::event::{self, KeyCode};
|
|
use ratatui::layout::{Constraint, Layout, Rect};
|
|
use ratatui::style::{Color, Style, Stylize};
|
|
use ratatui::text::{Line, Span};
|
|
use ratatui::widgets::{Row, Table, TableState};
|
|
use ratatui::{DefaultTerminal, Frame};
|
|
|
|
fn main() -> Result<()> {
|
|
color_eyre::install()?;
|
|
let terminal = ratatui::init();
|
|
let result = run(terminal);
|
|
ratatui::restore();
|
|
result
|
|
}
|
|
|
|
/// Run the application.
|
|
fn run(mut terminal: DefaultTerminal) -> Result<()> {
|
|
let mut table_state = TableState::default();
|
|
table_state.select_first();
|
|
table_state.select_first_column();
|
|
loop {
|
|
terminal.draw(|frame| render(frame, &mut table_state))?;
|
|
if let Some(key) = event::read()?.as_key_press_event() {
|
|
match key.code {
|
|
KeyCode::Char('q') | KeyCode::Esc => return Ok(()),
|
|
KeyCode::Char('j') | KeyCode::Down => table_state.select_next(),
|
|
KeyCode::Char('k') | KeyCode::Up => table_state.select_previous(),
|
|
KeyCode::Char('l') | KeyCode::Right => table_state.select_next_column(),
|
|
KeyCode::Char('h') | KeyCode::Left => table_state.select_previous_column(),
|
|
KeyCode::Char('g') => table_state.select_first(),
|
|
KeyCode::Char('G') => table_state.select_last(),
|
|
_ => {}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/// Render the UI with a table.
|
|
fn render(frame: &mut Frame, table_state: &mut TableState) {
|
|
let vertical = Layout::vertical([Constraint::Length(1), Constraint::Fill(1)]).spacing(1);
|
|
let [top, main] = vertical.areas(frame.area());
|
|
|
|
let title = Line::from_iter([
|
|
Span::from("Table Widget").bold(),
|
|
Span::from(" (Press 'q' to quit and arrow keys to navigate)"),
|
|
]);
|
|
frame.render_widget(title.centered(), top);
|
|
|
|
render_table(frame, main, table_state);
|
|
}
|
|
|
|
/// Render a table with some rows and columns.
|
|
pub fn render_table(frame: &mut Frame, area: Rect, table_state: &mut TableState) {
|
|
let header = Row::new(["Ingredient", "Quantity", "Macros"])
|
|
.style(Style::new().bold())
|
|
.bottom_margin(1);
|
|
|
|
let rows = [
|
|
Row::new(["Eggplant", "1 medium", "25 kcal, 6g carbs, 1g protein"]),
|
|
Row::new(["Tomato", "2 large", "44 kcal, 10g carbs, 2g protein"]),
|
|
Row::new(["Zucchini", "1 medium", "33 kcal, 7g carbs, 2g protein"]),
|
|
Row::new(["Bell Pepper", "1 medium", "24 kcal, 6g carbs, 1g protein"]),
|
|
Row::new(["Garlic", "2 cloves", "9 kcal, 2g carbs, 0.4g protein"]),
|
|
];
|
|
let footer = Row::new([
|
|
"Ratatouille Recipe",
|
|
"",
|
|
"135 kcal, 31g carbs, 6.4g protein",
|
|
]);
|
|
let widths = [
|
|
Constraint::Percentage(30),
|
|
Constraint::Percentage(20),
|
|
Constraint::Percentage(50),
|
|
];
|
|
let table = Table::new(rows, widths)
|
|
.header(header)
|
|
.footer(footer.italic())
|
|
.column_spacing(1)
|
|
.style(Color::White)
|
|
.row_highlight_style(Style::new().on_black().bold())
|
|
.column_highlight_style(Color::Gray)
|
|
.cell_highlight_style(Style::new().reversed().yellow())
|
|
.highlight_symbol("🍴 ");
|
|
|
|
frame.render_stateful_widget(table, area, table_state);
|
|
}
|