diff --git a/packages/fullstack/src/lib.rs b/packages/fullstack/src/lib.rs index b9318d0d6..72f4340c9 100644 --- a/packages/fullstack/src/lib.rs +++ b/packages/fullstack/src/lib.rs @@ -60,5 +60,5 @@ pub mod prelude { pub use dioxus_ssr::incremental::IncrementalRendererConfig; pub use server_fn::{self, ServerFn as _, ServerFnError}; - pub use use_server::server_cached; + pub use use_server::from_server; } diff --git a/packages/fullstack/src/use_server/mod.rs b/packages/fullstack/src/use_server/mod.rs index dc47b5bca..f0f76d16f 100644 --- a/packages/fullstack/src/use_server/mod.rs +++ b/packages/fullstack/src/use_server/mod.rs @@ -1,7 +1,23 @@ use serde::{de::DeserializeOwned, Serialize}; -/// TODO: Document this -pub fn server_cached(server_fn: impl Fn() -> O) -> O { +/// 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::*; +/// use dioxus_fullstack::prelude::*; +/// +/// fn app(cx: Scope) -> Element { +/// let state1 = use_state(cx, || from_server(|| { +/// 1234 +/// })); +/// } +/// ``` +pub fn from_server(server_fn: impl Fn() -> O) -> O { #[cfg(feature = "ssr")] { let data =