adam/leptos-use
1
0
Fork 0
mirror of https://github.com/adoyle0/leptos-use.git synced 2025-01-22 16:49:22 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

Merge pull request #86 from flupke/add-ssr-feature-note

Browse source 
Add ssr feature note to the book
This commit is contained in:
Marc-Stefan Cassola 2024-03-03 10:26:21 +00:00 • committed by GitHub
commit 673d63449f
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 23 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
docs/book/src/server_side_rendering.md
View file

@ -10,7 +10,7 @@ In your Cargo.toml file add the following:
[features]
hydrate = [
"leptos/hydrate",
"leptos/hydrate",
...
]
ssr = [
@ -30,6 +30,25 @@ find information about these differences in their respective docs under the sect
If you don't find that section, it means that the function works exactly the same on both, the client
and the server.
> **Note:** do not enable `leptos-use`'s `ssr` feature directly!
>
> ```toml
> [dependencies]
> leptos-use = { version = "0.10", features = ["ssr"] } # do not do this
> ```
The `ssr` feature is used to select which version of the functions are built.
Effectively it means your application is built two times: with `ssr` enabled to
build the server executable, and with `ssr` disabled to build the client's WASM
binary module.
So if you enable `leptos-use`'s `ssr` feature globally, you will get the server
version of the functions in the client.
By adding `"leptos-use/ssr"` to the `ssr` feature of your project, it will only
be enabled when your project is built with `ssr`, and you will get the server
functions server-side, and the client functions client-side.
## Functions with Target Elements
A lot of functions like `use_resize_observer` and `use_element_size` are only useful when a target HTML/SVG element is
@ -47,8 +66,9 @@ use leptos_use::{use_event_listener, use_window};
use_event_listener(use_window(), keyup, |evt| {
...
});
});
```
There are some convenience methods provided as well, like `use_document().body()` which
just propagate a `None` on the server.
just propagate a `None` on the server.