7af0065a9b | ||
---|---|---|
.cargo | ||
.vscode | ||
TODO | ||
examples | ||
tests | ||
tools | ||
zero-ui | ||
zero-ui-app | ||
zero-ui-app-proc-macros | ||
zero-ui-app_context | ||
zero-ui-clone_move | ||
zero-ui-color | ||
zero-ui-color-proc-macros | ||
zero-ui-ext-clipboard | ||
zero-ui-ext-config | ||
zero-ui-ext-font | ||
zero-ui-ext-fs_watcher | ||
zero-ui-ext-image | ||
zero-ui-ext-input | ||
zero-ui-ext-l10n | ||
zero-ui-ext-l10n-proc-macros | ||
zero-ui-ext-undo | ||
zero-ui-ext-window | ||
zero-ui-handle | ||
zero-ui-l10n-scraper | ||
zero-ui-layout | ||
zero-ui-state_map | ||
zero-ui-task | ||
zero-ui-task-proc-macros | ||
zero-ui-txt | ||
zero-ui-unique_id | ||
zero-ui-unit | ||
zero-ui-var | ||
zero-ui-var-proc-macros | ||
zero-ui-view | ||
zero-ui-view-api | ||
zero-ui-view-prebuilt | ||
zero-ui-wgt | ||
zero-ui-wgt-access | ||
zero-ui-wgt-ansi_text | ||
zero-ui-wgt-button | ||
zero-ui-wgt-checkerboard | ||
zero-ui-wgt-container | ||
zero-ui-wgt-data | ||
zero-ui-wgt-fill | ||
zero-ui-wgt-filter | ||
zero-ui-wgt-grid | ||
zero-ui-wgt-image | ||
zero-ui-wgt-input | ||
zero-ui-wgt-inspector | ||
zero-ui-wgt-layer | ||
zero-ui-wgt-link | ||
zero-ui-wgt-markdown | ||
zero-ui-wgt-material-icons | ||
zero-ui-wgt-menu | ||
zero-ui-wgt-panel | ||
zero-ui-wgt-rule_line | ||
zero-ui-wgt-scroll | ||
zero-ui-wgt-size_offset | ||
zero-ui-wgt-stack | ||
zero-ui-wgt-style | ||
zero-ui-wgt-switch | ||
zero-ui-wgt-text | ||
zero-ui-wgt-text_input | ||
zero-ui-wgt-toggle | ||
zero-ui-wgt-tooltip | ||
zero-ui-wgt-transform | ||
zero-ui-wgt-undo | ||
zero-ui-wgt-undo_history | ||
zero-ui-wgt-view | ||
zero-ui-wgt-window | ||
zero-ui-wgt-wrap | ||
.gitattributes | ||
.gitignore | ||
.gitmodules | ||
CHANGELOG.md | ||
Cargo.toml | ||
LICENSE | ||
README.md | ||
do | ||
do.bat | ||
do.ps1 | ||
git-dependencies.md | ||
rustfmt.toml |
README.md
zero-ui
Zero-Ui is the pure Rust GUI framework with batteries included.
It provides all that you need to create a beautiful, fast and responsive multi-platform GUI apps, it includes many features that allow you to get started quickly, without sacrificing customization or performance. With features like gesture events, common widgets, layouts, data binding, async tasks, accessibility and localization you can focus on what makes your app unique, not the boilerplate required to get modern apps up to standard.
When you do need to customize, Zero-Ui is rightly flexible, you can create new widgets or customize existing ones, not just new looks but new behavior, at a lower level you can introduce new event types or new event sources, making custom hardware seamless integrate into the framework.
Usage
First add this to your Cargo.toml
:
[dependencies]
zero-ui = "0.1"
zero-ui-view = "0.1"
Then create your first window:
use zero_ui::prelude::*;
fn main() {
zero_ui_view::init();
APP.defaults().run_window(async {
let size = var(layout::Size::new(800, 600));
Window! {
title = size.map(|s| formatx!("Button Example - {s}"));
size;
child_align = Align::CENTER;
child = Button! {
on_click = hn!(|_| {
println!("Button clicked!");
});
text::font_size = 28;
child = Text!("Click Me!");
}
}
})
}
See the API docs
front page for more details.
Dependencies
Extra system dependencies needed for building a crate that uses the zero-ui
crate.
Windows
You just need the latest stable Rust toolchain installed.
Linux
- Latest stable Rust.
build-essential
or equivalent C/C++ compiler package.cmake
pkg-config
libssl-dev
libfreetype6-dev
libfontconfig1-dev
Linux support is tested using the Windows Subsystem for Linux (Ubuntu image).
Other Dependencies
For debugging this project you may also need cargo-expand
and the nightly toolchain for debugging macros (do expand
), cargo-asm
for checking
optimization (do asm
).
You also need the nightly toolchain for building the documentation (do doc
), although you can
build the documentation in stable using cargo doc
, but custom pages like widget items may not
render properly because of changes in the cargo-doc
HTML templates.
cargo do
There is a built-in task runner for managing this project, run cargo do help
or ./do help
for details.
The task runner is implemented as a Rust crate in tools/do-tasks
and an alias in .cargo/config.toml
,
it builds the tool silently in the first run, after it should run without noticeable delay.
Shell script to run do
are also provided:
- cmd.exe:
do help
. - PowerShell:
./do.ps1 help
. - Bash:
/.do help
.
VSCode & Rust Analyzer
Some workspace settings are included in the repository, in particular, rust-analyzer
"checkOnSave"
and runnables are redirected to the do
tool.