dioxus-fullstack-hooks 0.7.0-rc.0

Hooks for serializing futures, values in dioxus-fullstack and other utilities
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

use dioxus_core::use_hook;
use dioxus_fullstack_protocol::SerializeContextEntry;
use serde::{de::DeserializeOwned, Serialize};

/// This allows you to send data from the server to the client. The data is serialized into the HTML on the server and hydrated on the client.
///
/// When you run this function on the client, you need to be careful to insure the order you run it initially is the same order you run it on the server.
///
/// If Dioxus fullstack cannot find the data on the client, it will run the closure again to get the data.
///
/// # Example
/// ```rust
/// use dioxus::prelude::*;
///
/// fn app() -> Element {
///    let state1 = use_server_cached(|| {
///       1234
///    });
///
///    unimplemented!()
/// }
/// ```
#[track_caller]
pub fn use_server_cached<O: 'static + Clone + Serialize + DeserializeOwned>(
    server_fn: impl Fn() -> O,
) -> O {
    let location = std::panic::Location::caller();
    use_hook(|| server_cached(server_fn, location))
}

pub(crate) fn server_cached<O: 'static + Clone + Serialize + DeserializeOwned>(
    value: impl FnOnce() -> O,
    #[allow(unused)] location: &'static std::panic::Location<'static>,
) -> O {
    let serialize = dioxus_fullstack_protocol::serialize_context();
    #[allow(unused)]
    let entry: SerializeContextEntry<O> = serialize.create_entry();
    #[cfg(feature = "server")]
    {
        let data = value();
        entry.insert(&data, location);
        data
    }
    #[cfg(all(not(feature = "server"), feature = "web"))]
    {
        match entry.get() {
            Ok(value) => value,
            Err(_) => value(),
        }
    }
    #[cfg(not(any(feature = "server", feature = "web")))]
    {
        value()
    }
}