zng

https://zng-ui.github.io/doc/zng

Zng is a cross-platform GUI framework, it provides ready made highly customizable widgets, responsive layout, live data binding, easy localization, automatic focus navigation and accessibility, async and multi-threaded tasks, robust multi-process architecture and more.

Zng is pronounced "zing", or as an initialism: ZNG (Z Nesting Graphics).

Usage

First add zng to your Cargo.toml, or call cargo add zng -F view_prebuilt:

[dependencies]
zng = { version = "0.17.0", features = ["view_prebuilt"] }

Then create your first window:

use zng::prelude::*;

fn main() {
    zng::env::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 documentation for more details.

Project Template

You can also use cargo zng new to generate a new project with useful boilerplate and distribution packaging already setup.

cargo install cargo-zng
cargo zng new "My App!"

The example above installs cargo-zng and uses it to generate a new './my-app' crate from the default template.

Cargo Features

This crate provides 80 feature flags, 1 enabled by default.

"dev"

Defaults recommended for the dev profile (debug builds).

Recommended Cargo.toml setup:

[dependencies]
zng = { default-features = false }

[features]
default = ["dev"]

# development features:
dev = [
  "zng/dev",
  "zng/view_prebuilt",
]

# release features:
# use `cargo build --release --no-default-features --features release` to build
release = [
  "zng/window",
  "zng/view",
  "zng/ipc",
  "zng/crash_handler",
  "zng/...",
]

Enabled by default.

"view"

Include the default view-process implementation.

Only enables in not(target_arch = "wasm32") builds.

"view_prebuilt"

Include the default view-process implementation as an embedded precompiled binary.

Only enables in not(any(target_arch = "wasm32", target_os = "android", target_os = "ios")) builds.

"http"

Enables HTTP tasks and web features of widgets and services.

"svg"

Enable SVG image rendering, SVG emoji support.

"inspector"

Instrument each property and widget instance with "Inspector" nodes and extend windows to be inspected on Ctrl+Shift+I.

"hot_reload"

Enable hot reload builds.

Note that you must configure the target library to hot reload, see zng::hot_reload for details.

Only enables in not(any(target_arch = "wasm32", target_os = "android", target_os = "ios")) builds.

"dyn_app_extension"

Use dynamic dispatch at the app-extension level.

This speeds-up compilation time at the cost of runtime.

"test_util"

Test utilities.

"multi_app"

Allows multiple app instances per-process.

This feature allows multiple apps, one app per thread at a time. The LocalContext tracks what app is currently running in each thread and app_local! statics switch to the value of each app depending on the current thread.

Not enabled by default, but enabled by feature="test_util".

"single_instance"

Enables single app-process instance mode.

Builds with this feature only allow one app-process, subsequent attempts to spawn the app redirect to the running app-process.

Only enables in not(any(target_arch = "wasm32", target_os = "android", target_os = "ios")) builds.

"crash_handler"

Allow app-process crash handler.

Builds with this feature spawn a crash monitor-process for each app-process.

Only enables in not(any(target_arch = "wasm32", target_os = "android")) builds.

"crash_handler_debug"

Enable debug crash handler view.

"trace_widget"

Instrument every widget outer-most node to trace UI methods.

"trace_recorder"

Enable trace recording.

Note that this does not auto start recording, to do that run with the ZNG_RECORD_TRACE env var set.

"trace_wgt_item"

Instrument every property and intrinsic node to trace UI methods.

Note that this can cause very large trace files and bad performance.

"deadlock_detection"

Spawns a thread on app creation that checks and prints parking_lot deadlocks.

"hyphenation_embed_all"

Embed hyphenation dictionaries for all supported languages.

If enabled some 2.8MB of data is embedded, you can provide an alternative dictionary source using the HYPHENATION::init_data_source method.

"material_icons"

Include all Material Icons icon sets in the default app.

"material_icons_outlined"

Material Icons Outlined icon set.

If enabled some icons of this set are used for some of the commands.

"material_icons_filled"

Material Icons Filled icon set.

"material_icons_rounded"

Material Icons Rounded icon set.

"material_icons_sharp"

Material Icons Sharp icon set.

"var_type_names"

Compile with var value type names for better error messages and diagnostics.

"config_json"

Enable JSON config format and file watcher helper.

"config_toml"

Enable TOML config format and file watcher helper.

"config_ron"

Enable RON config format and file watcher helper.

"config_yaml"

Enable YAML config format and file watcher helper.

"config_all"

Enable all config formats an file watcher helpers.

"view_software"

Enables software renderer fallback in the default view-process.

If enabled and a native OpenGL 3.2 driver is not available the swgl software renderer is used.

"view_bundle_licenses"

Collects and bundles third-party licenses used by the zng-view crate.

Needs cargo-about and Internet connection during build.

Not enabled by default. Note that "view_prebuilt" always bundles licenses.

"ipc"

Enables IPC tasks, pre-build views and connecting to views running in another process.

Only enables in not(any(target_os = "android", target_arch = "wasm32", target_os = "ios")) builds.

"built_res"

Check if zng::env::res path is available in init_built_res first.

Enabled by default in debug builds, ignored in Android and Wasm.

"android_game_activity"

Standard Android backend that requires a build system that can compile Java or Kotlin and fetch Android dependencies.

See https://docs.rs/winit/latest/winit/platform/android/ for more details.

"android_native_activity"

Basic Android backend that does not require Java.

See https://docs.rs/winit/latest/winit/platform/android/ for more details.

"window"

Enable window, monitor services, widgets and properties.

"third_party"

Enable third-party license service and types.

"third_party_default"

Enable default third-party licenses default view.

"ansi_text"

Enable ANSI text widget.

Not enabled by default.

"checkerboard"

Enable checkerboard widget.

"clipboard"

Enable clipboard service.

"color_filter"

Enable color filter properties.

"fs_watcher"

Enable file system watcher service.

"config"

Enable the configuration service.

"settings_editor"

Enable settings widgets.

"data_context"

Enable data context service and properties.

"data_view"

Enable data view widget.

"dialog"

Enable modal dialog overlay widget and service.

"drag_drop"

Enable drag&drop.

"grid"

Enable grid widget.

"image"

Enable image service, widgets, window icons, image cursors, frame capturing.

"markdown"

Enable markdown widget.

"menu"

Enable menu widgets.

"progress"

Enable progress indicator widgets.

"rule_line"

Enable rule line widgets.

"scroll"

Enable scroll widget.

"button"

Enable button widget.

"toggle"

Enable toggle widgets.

"slider"

Enable slider widget.

"stack"

Enable stack widget.

"text_input"

Enable text input widgets.

"tooltip"

Enable tooltip widget.

"undo"

Enable undo/redo service.

"wrap"

Enable wrap widget.

"shortcut_text"

Enable the shortcut text widget.

"image_bmp"

Enable BMP image decoder and encoder with "view" feature.

"image_dds"

Enable DDS image decoder with "view" feature.

"image_exr"

Enable EXR image decoder and encoder with "view" feature.

"image_ff"

Enable Farbfeld image decoder and encoder with "view" feature.

"image_gif"

Enable GIF image decoder and encoder with "view" feature.

"image_hdr"

Enable Radiance HDR image decoder and encoder with "view" feature.

"image_ico"

Enable ICO image decoder and encoder with "view" feature.

"image_jpeg"

Enable JPEG image decoder and encoder with "view" feature.

"image_png"

Enable PNG image decoder and encoder with "view" feature.

"image_pnm"

Enable PNM image decoder and encoder with "view" feature.

"image_qoi"

Enable QOI image decoder and encoder with "view" feature.

"image_tga"

Enable TGA image decoder and encoder with "view" feature.

"image_tiff"

Enable TIFF image decoder and encoder with "view" feature.

"image_webp"

Enable WEBP image decoder with "view" feature.

"image_all"

Enable all encoders and decoders.

Repository

See the zng-ui/zng repository README for more information about build requirements, examples and license information.