leptos-use 0.20.0

Usage

Every function lives in its own small crate, e.g. use_mouse in leptos-use-mouse:

cargo add leptos-use-mouse

The docs tell you which crate to add for each function. The all-in-one leptos-use crate is deprecated: it only re-exports the micro crates and its deprecation warnings tell you which crate to add instead.

use leptos::prelude::*;
use leptos_use_mouse::{use_mouse, UseMouseReturn};

#[component]
fn Demo() -> impl IntoView {
    let UseMouseReturn { x, y, .. } = use_mouse();

    view! { cx,
        {x} " x " {y}
    }
}

Missing a function? Open a ticket or PR!

Development

To run all tests run

# Run tests (general)
cargo test --workspace --features math,docs,ssr

# Run tests (axum) use_cookie
cargo test -p leptos-use-cookie --features ssr,axum --doc

# Run tests (axum) use_locale
cargo test -p leptos-use-locale --features ssr,axum --doc

# Run tests (actix) use_cookie
cargo test -p leptos-use-cookie --features ssr,actix --doc

# Run tests (actix) use_locale
cargo test -p leptos-use-locale --features ssr,actix --doc

Book

First you need to install

cargo install mdbook trunk

To build the book go in your terminal into the docs/book folder and run

mdbook serve

This builds the html version of the book and runs a local dev server. To also add in the examples open another shell and run

python3 post_build.py

If you only want to add the example for one function you can run for example

python3 post_build.py use_storage

New Function Template

To scaffold a new function quickly you can run template/createfn.sh. It requires that ffizer and Python 3 is installed. This will create the function file in the src directory, scaffold an example directory and an entry in the book.

Leptos compatibility