32 releases (20 stable)

1.8.0 Sep 23, 2024
1.7.1 Jul 25, 2024
1.5.1 Mar 20, 2024
1.3.2 Dec 1, 2023
0.2.1 Mar 10, 2022

#921 in GUI

Download history 100/week @ 2024-07-08 209/week @ 2024-07-15 229/week @ 2024-07-22 121/week @ 2024-07-29 60/week @ 2024-08-05 221/week @ 2024-08-12 190/week @ 2024-08-19 46/week @ 2024-08-26 60/week @ 2024-09-02 71/week @ 2024-09-09 149/week @ 2024-09-16 280/week @ 2024-09-23 239/week @ 2024-09-30 78/week @ 2024-10-07 69/week @ 2024-10-14 53/week @ 2024-10-21

458 downloads per month
Used in 3 crates

GPL-3.0-only…

4MB
76K SLoC

Slint interpreter library

With this crate, you can load a .slint file at runtime and show its UI.

You only need to use this crate if you do not want to use pre-compiled .slint code, which is the normal way to use Slint, using the slint crate

The entry point for this crate is the Compiler type, which you can use to create CompilationResult with the Compiler::build_from_source or Compiler::build_from_path functions. CompilationResult provides access to all components declared for export. Obtain a ComponentDefinition for each and use [ComponentDefinition::create()] to instantiate a component. The returned ComponentInstance in turn provides access to properties, callbacks, functions, global singletons, as well as implementing ComponentHandle.

Note about async functions

Compiling a component is async but in practice, this is only asynchronous if Compiler::set_file_loader is set and its future is actually asynchronous. If that is not used, then it is fine to use a very simple executor, such as the one provided by the spin_on crate

Examples

This example loads a .slint dynamically from a path and show errors if any:

use slint_interpreter::{ComponentDefinition, Compiler, ComponentHandle};

let compiler = Compiler::default();
let result = spin_on::spin_on(compiler.build_from_path("hello.slint"));
let diagnostics : Vec<_> = result.diagnostics().collect();
diagnostics.print();
if let Some(definition) = result.component("Foo") {
let instance = definition.create().unwrap();
instance.run().unwrap();
}

This example load a .slint from a string and set some properties:

use slint_interpreter::{ComponentDefinition, Compiler, Value, SharedString, ComponentHandle};

let code = r#"
export component MyWin inherits Window {
in property <string> my_name;
Text {
text: "Hello, " + my_name;
}
}
"#;

let mut compiler = Compiler::default();
let result =
spin_on::spin_on(compiler.build_from_source(code.into(), Default::default()));
assert_eq!(result.diagnostics().count(), 0);
let definition = result.component("MyWin");
let instance = definition.unwrap().create().unwrap();
instance.set_property("my_name", Value::from(SharedString::from("World"))).unwrap();
instance.run().unwrap();

Feature flags

Dependencies

~7–48MB
~816K SLoC