Crates.io | egui-data-table |
lib.rs | egui-data-table |
version | 0.3.0 |
source | src |
created_at | 2024-03-06 14:00:50.543675 |
updated_at | 2024-08-06 01:10:26.482005 |
description | A generic data table widget implmentation for egui |
homepage | |
repository | https://github.com/kang-sw/egui-data-table |
max_upload_size | |
id | 1164850 |
size | 203,818 |
MSRV is 1.75, with RPITIT
In Cargo.toml
, add egui-data-table
to your dependencies section
[dependencies]
egui-data-table = "0.1"
Minimal example:
// Use same version of `egui` with this crate!
use egui_data_table::egui;
// Don't need to implement any trait on row data itself.
struct MyRowData(i32, String, bool);
// Every logic is defined in `Viewer`
struct MyRowViewer;
// There are several methods that MUST be implemented to make the viewer work correctly.
impl egui_data_table::RowViewer<MyRowData> for MyRowViewer {
fn num_columns(&mut self) -> usize {
3
}
fn show_cell_view(&mut self, ui: &mut egui::Ui, row: &MyRowData, column: usize) {
let _ = match column {
0 => ui.label(format!("{}", row.0)),
1 => ui.label(&row.1),
2 => ui.checkbox(&mut { row.2 }, ""),
_ => unreachable!()
};
}
fn show_cell_editor(
&mut self,
ui: &mut egui::Ui,
row: &mut MyRowData,
column: usize,
) -> Option<egui::Response> {
match column {
0 => ui.add(egui::DragValue::new(&mut row.0).speed(1.0)),
1 => {
egui::TextEdit::multiline(&mut row.1)
.desired_rows(1)
.code_editor()
.show(ui)
.response
}
2 => ui.checkbox(&mut row.2, ""),
_ => unreachable!()
}
.into() // To make focusing work correctly, valid response must be returned.
}
fn set_cell_value(&mut self, src: &MyRowData, dst: &mut MyRowData, column: usize) {
match column {
0 => dst.0 = src.0,
1 => dst.1 = src.1.clone(),
2 => dst.2 = src.2,
_ => unreachable!()
}
}
fn new_empty_row(&mut self) -> MyRowData {
// Instead of requiring `Default` trait for row data types, the viewer is
// responsible of providing default creation method.
MyRowData(0, Default::default(), false)
}
// fn clone_row(&mut self, src: &MyRowData) -> MyRowData
// ^^ Overriding this method is optional. In default, it'll utilize `set_cell_value` which
// would be less performant during huge duplication of lines.
}
fn show(ui: &mut egui::Ui, table: &mut egui_data_table::DataTable<MyRowData>) {
ui.add(egui_data_table::Renderer::new(
table,
&mut { MyRowViewer },
));
}
For more details / advanced usage, see demo