1 unstable release

0.0.0	May 30, 2019

#73 in #wasm-framework

Custom license

56KB
1.5K SLoC

`Mika`

An experimental opinionated framework for frontend wasm app, base on futures-signals and wasm-bindgen. Mika is inspired by Dominator.

Compare to Dominator

	`Dominator`	`Mika`
Status	"It is generally feature complete [...]" - Quoted from its README	experimental. No single line of `#[test]` yet. It's just enough to run a partial version of TodoMVC (no routing, no persistent storage)
Base on	Stdweb (stdweb is now also based on wasm-bindgen)	wasm-bindgen directly
Separation of updating and rendering.	By design, no! But can be easily added.	Yes, it tries to help users separating the app-view-renderer and the app-state-updater. It's impossible to prevent users from insert app-state-mutating code into the render, but at least, `Mika` give its users a way to extract such code out of the renderer.
DOM contruction	html!("div", {.class("some-class"), [...chilren...]})	Div::new().class("some-class").child(...).child(...)

Pros and cons

Both biggest advantage and biggest disadvantage are come from futures-signals.

Pros

futures-signals helps triggering the right parts of the code to response to a change in your app. (Contrast to virtual DOM approachs, which must walk through the whole virtual DOM to find diffs)

Cons

You must learn futures-signals.
Because of futures-signals, you find yourself fighting the borrow checker more often.

Build and serve

You must install Rust
rustup install nightly (futures-signals build with futures 0.3 which requires nightly)
rustup target add wasm32-unknown-unknown --toolchain=nightly (because we build for the web browser)
cargo install wasm-bindgen-cli (Mika build on top of wasm-bindgen)
cargo install simi-cli (Mika is similar to Simi)
git clone https://gitlab.com/limira-rs/mika.git
cd examples/counter
simi serve (yes, it's simi serve, because we use simi-cli)

Wait for the build to complete, then open your browser and visit http://localhost:8000/!

Documentation

Not completed yet.

Minor notes:

You get signal/signal_vec from an instance of Mutable<T>/MutableVec<T> where T: Copy,
You get signal_cloned/signal_vec_cloned from an instance of Mutable<T>/MutableVec<T> where T: Clone,

Permitted content of an element

Mika tries to help you with the restrictions when adding child-elements to an element. If you find out that it does not allow a valid child or allow an invalid child (or any other bug), feel free to open an issue. Mika is unable to help on other restrictions such as descendant elements (child-elements in a child-element), child-element which is valid/invalid when with/without an attribute, order of child-elements...

There is still a bunch of TODO in src/dom/mod.rs, contributions are welcome.

Dependencies

~17MB
~318K SLoC