Grid, Flexbox, Block layout support for egui using taffy
Grid, Flexbox, Block layout support for egui using taffy
Flexible egui layout library that supports CSS Block, Flexbox, Grid layouts. It uses high-performance taffy library under the hood.
This library is in active development and some breaking changes are expected, but they will be kept as small as possible.
| egui_taffy | egui | taffy | MSRV |
|---|---|---|---|
| 0.14 | 0.36 | 0.9.2 | 1.95 |
| 0.13 | 0.35 | 0.9.2 | 1.92 |
| 0.12 | 0.34 | 0.9.2 | 1.92 |
| 0.11 | 0.34 | 0.7.7 | 1.92 |
| 0.10 | 0.33 | 0.7.7 | 1.88 |
| 0.9 | 0.32 | 0.7.7 | 1.85 |
| 0.8 | 0.32 | 0.7.7 | 1.85 |
| 0.7 | 0.31 | 0.7.3 | 1.81 |
| 0.6 | 0.30 | 0.7.3 | 1.81 |
| 0.5 | 0.30 | 0.7 | 1.83 |
| 0.4 | 0.30 | 0.7 | 1.83 |
| 0.3 | 0.29 | 0.7 | 1.83 |
| 0.2 | 0.29 | 0.7 | 1.83 |
| 0.1.2 | 0.29 | 0.6 | 1.83 |
| 0.1 | 0.29 | 0.6 | 1.83 (nightly) |
To use add egui_taffy to your project dependencies in Cargo.toml file.
See CHANGELOG for changes between versions.
Check out ./examples/demo.rs (cargo run --example demo).
…Preview:
Supports scrollable elements!
https://github.com/user-attachments/assets/07546146-7a90-422b-b291-99b758fd7704
Support grids with equal virtual row height. Rows can contain merged cells (colspan).
https://github.com/user-attachments/assets/a3c8ebba-e72f-44c2-9233-29004b97d070
For best visual look you should enable egui multiple passes support so layout can be immediately recalculated upon some changes.
ctx.options_mut(|options| {
options.max_passes = std::num::NonZeroUsize::new(2).unwrap();
});If integrating with egui implementations such as bevy_egui, for egui multipass (request_discard) functionality to work you need to use special approach. See bevy_egui simple_multipass example for such case.
By default egui text wrapping tries to utilize as less width as possible. In dynamic layouts it results in text where letters are placed in a column.
Instead you should use one of the following options:
tui.wrap_mode(egui::TextWrapMode::Truncate).add(|tui| { ... })ctx.all_styles_mut(|style| {
style.wrap_mode = Some(egui::TextWrapMode::Extend);
});This crate is inspired by lucasmerlin previous exploration in this direction by such crates as:
It combines ideas from both crates and builds upon them to provide easy to use egui like API to write your UI with modern layout support.
Library uses intrinsic size and request_discard egui functionality to measure layout and request immediate frame redraw (without even drawing the current frame) if layout has changed.
Contributions are welcome. Please add your improvements to examples so that it is easy to see and validate.
No open issues yet, or sync has not completed.