Evan Almloff ee3b45af49 Restore docs CI checks and fix all doc lints (#4204) 1 lună în urmă
..
src 40ce4c269d Fix setting option value to an empty string (#4176) 1 lună în urmă
tests b5447c162f extend interpreter base class with platform methods 1 an în urmă
.gitignore b5447c162f extend interpreter base class with platform methods 1 an în urmă
Cargo.toml a1107de0c0 Update axum and many dependencies (#3825) 2 luni în urmă
NOTES.md b5447c162f extend interpreter base class with platform methods 1 an în urmă
README.md ee3b45af49 Restore docs CI checks and fix all doc lints (#4204) 1 lună în urmă
build.rs 88af3e7eff Hotreloading of `for/if/body`, formatted strings, literals, component props, nested rsx, light CLI rewrite, cli TUI (#2258) 11 luni în urmă
tsconfig.json 2f49a89638 Add the `onresize` event handler to Element (#2479) 10 luni în urmă

README.md

dioxus-interpreter-js

Crates.io MIT licensed Build Status Discord chat

Website | Guides | API Docs | Chat

Overview

dioxus-interpreter-js provides the high-performance JavaScript glue that interprets the stream of edits produced by the Dioxus VirtualDom and converts them into mutations on the actual web DOM.

This crate features bindings for the web and sledgehammer for increased performance.

Architecture

We use TypeScript to write the bindings and a very simple build.rs along with bun to convert them to javascript, minify them, and glue them into the rest of the project.

Not every snippet of JS will be used, so we split out the snippets from the core interpreter.

In theory, we could use Rust in the browser to do everything these bindings are doing. In reality, we want to stick with JS to skip the need for a WASM build step when running the LiveView and WebView renderers. We also want to use JS to prevent diverging behavior of things like canceling events, uploading files, and collecting form inputs. These details are tough to ensure 1:1 compatibility when implementing them in two languages.

If you want to contribute to the bindings, you'll need to have the typescript compiler installed on your machine as well as bun:

https://bun.sh/docs/installation

Contributing

  • Report issues on our issue tracker.
  • Join the discord and ask questions!

License

This project is licensed under the MIT license.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Dioxus by you shall be licensed as MIT without any additional terms or conditions.