Collection of essential Leptos utilities inspired by React-Use / VueUse / SolidJS-USE
Find a file
Marc-Stefan Cassola 86ebd5b531
Update README.md
2024-09-25 19:57:07 +01:00
.cargo Fix web_sys_unstable_apis not passed to rustdoc 2024-07-27 19:41:48 +02:00
.fleet Problem: CI references storage feature. Replace with serde,prost 2023-11-11 10:43:32 +00:00
.github added use_locale 2024-07-28 20:34:38 +01:00
.idea added use_textarea_autosize 2024-09-15 20:41:51 +02:00
docs added use_textarea_autosize 2024-09-15 20:41:51 +02:00
examples added use_textarea_autosize 2024-09-15 20:41:51 +02:00
src added use_textarea_autosize 2024-09-15 20:41:51 +02:00
template properly handle web-sys unstable apis config in the new function template 2024-09-02 12:12:11 +01:00
.gitignore Fixed dependency issue 2024-01-22 07:54:47 +05:30
build.rs ssr + wasm compile warning 2024-05-10 14:15:59 -05:00
Cargo.toml added use_textarea_autosize 2024-09-15 20:41:51 +02:00
CHANGELOG.md added use_textarea_autosize 2024-09-15 20:41:51 +02:00
LICENSE-APACHE initial commit 2023-05-12 20:22:16 +01:00
LICENSE-MIT initial commit 2023-05-12 20:22:16 +01:00
README.md Update README.md 2024-09-25 19:57:07 +01:00


Leptos-Use – Collection of essential Leptos utilities

Collection of essential Leptos utilities

Inspired by React-Use / VueUse

Crates.io SSR Docs & Demos 87 Functions




Usage

Docs MIT/Apache 2.0 Build Status Discord

use leptos::*;
use leptos_use::{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

cargo test --all-features

Book

First you need to install

cargo install mdbook mdbook-cmdrun 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

Crate version Compatible Leptos version
<= 0.3 0.3
0.4, 0.5, 0.6 0.4
0.7, 0.8, 0.9 0.5
0.10 0.13 0.6