Additional widgets for ratatui.
These widgets are designed to operate similar to the built-in widgets in tui-rs, and should fit into your app cleanly.
TODO: Add example gifs
This isn't yet a published crate, but the widgets are all documented. Docs are best built with:
cargo doc --document --private-items
Since the internals are documented as well.
By default all the widgets are built and available:
[dependencies]
extra-widgets = "0.0.1"
ratatui = "0.20.0"Alternately, each widget can be enabled individually. The feature names are the same as the module name for the widget. To just use the calendar widget:
[dependencies]
extra-widgets = {"0.0.1" default-features = false, features = ["calendar"] }
ratatui = "0.20.0"Dependencies for each widget are only pulled if the feature is enabled.
Macros (e.g. bold!(...)) are gated by the text_macros feature.
State structs can be serialized with Serde by enabling the serde feature. This can be useful
(for example) in apps that wish to save state to disk and restore it on the next run.
Serializeable states:
- styled_list::ListState
These started as functionality I wanted in my own projects, and I thought they might be generally useful, so this project was born. Long term, I'd like to add this to some collection for tui/ratatui, or as a seed for such a collection. Or barring that, come up with a decent name and publish as a crate.