What is agui?
Agui is an advanced reactive GUI project for Rust, inspired by Flutter and taking some concepts from other related UI systems.
WARNING
Agui is very much still in heavy active development. The API will likely change, and it has yet to go under rigorous testing. However, that's not to say it's not ready for moderate use.
🛠️
Installation
Agui is available on crates.io, Rust's official package repository. Just add this to your Cargo.toml file:
[dependencies]
agui = "0.1" # ensure this is the latest version
🚀
Usage
Docs for agui are under development, however you can check the agui_agpu/examples directory for basic setup, and agui_widgets for many examples on widget creation.
Creating new widgets
Currently, widgets are created using a Widget derive macro, and by implementing the WidgetImpl trait.
#[derive(Default, Widget)]
// The default layout type is "column" but we want it to be a "row" instead.
#[widget(layout = "row")]
pub struct MyWidget {
// We can define parameters, here.
pub layout: Ref<Layout>,
}
impl WidgetImpl for MyWidget {
// Widgets can return nothing, one or more children, or an error. BuildResult is the enum we use to cover those possibilities.
fn build(&self, ctx: &WidgetContext) -> BuildResult {
// `ctx.set_layout` is what we use to define this widget's layout parameters.
ctx.set_layout(Ref::clone(&self.layout));
build! {
Button { }
}
}
}
What's build!?
The build! macro makes it significantly cleaner and easier to init new widgets. All it does is initialize unset fields in a struct to their Default::default(), and add .into() to the struct itself.
// It allows us to turn this:
fn build(&self, ctx: &WidgetContext) -> BuildResult {
BuildResult::One(
Button {
layout: Layout::default(),
color: Color::default(),
child: Text {
text: String::from("A Button")
}
}
)
}
// Into this:
use agui::macros::build;
fn build(&self, ctx: &WidgetContext) -> BuildResult {
build!{
Button {
child: Text {
text: String::from("A Button")
}
}
}
}
A more complex widget implementation (featuring global state and computed values) can be seen in the Button widget.
Functional Widgets are coming soon, which will make creating them even easier.
🤝
Contributing
Contributions are encouraged, and very welcome. Feel free to check the issues page if you wish to do so!
Please go through existing issues and pull requests to check if somebody else is already working on it. Also, make sure to run cargo test before you commit your changes!
5 Jul 31, 2022
493 Jan 4, 2023
0 Feb 17, 2022
18 Jan 5, 2023
2 Jul 9, 2023
223 Dec 26, 2022
373 Dec 27, 2022
21 Dec 16, 2021
45 Dec 17, 2022
20 Dec 12, 2022
1 Dec 18, 2021
0 Dec 23, 2021
1 Feb 4, 2022
21 Nov 17, 2022
20 Dec 26, 2022
62 Dec 5, 2022
6 Sep 3, 2022
16 Dec 23, 2022
6 Jul 27, 2022