dioxus/packages/hooks
2021-10-16 17:37:28 -04:00
..
examples feat: massage lifetimes 2021-10-16 17:37:28 -04:00
src feat: massage lifetimes 2021-10-16 17:37:28 -04:00
Cargo.toml publish: remove wildcard 2021-09-24 20:57:52 -04:00
README.md wip: some project refactor 2021-07-09 11:54:07 -04:00

Common hooks for Dioxus

This crate includes some basic useful hooks for dioxus:

  • use_state
  • use_ref
  • use_collection
  • use_task
  • use_signal

use_state

The king daddy of state hooks.

You can always use it "normally" with the split method:

// Normal usage:
let value = use_state(cx, || 10);

// "Classic" usage:
let (value, set_value) = use_state(cx, || 0).classic();

use_ref

use_rwlock

A multithreaded form of RwLock for use in tasks

let val = use_rwlock(cx, || 10);
use_task((), || async loop {
    *val.write().unwrap() += 1;
    async_std::task::delay(Duration::from_ms(1000)).await;
});
use_task((), || async loop {
    *val.write().unwrap() -= 1;
    async_std::task::delay(Duration::from_ms(500)).await;
});

use_hashmap

Store a memoized collection with similar semantics to use_state. Comes with a bunch of utility methods to make working with collections easier. Is essentially a wrapper over the immutable hashmap in im-rc.

let todos = use_hashmap(cx, |map| map.insert("bob", "bill"));
cx.render(rsx!(
    button { onclick: move |_| todos.insert("bob", "bill")
        "add random todo"
    }
)

use_task

use_task submits a task to the dioxus task queue to be progressed during Dioxus's async event loop. The task must not return anything

use_signal