mirror of
https://github.com/adoyle0/leptos-use.git
synced 2025-01-23 00:59:22 -05:00
93 lines
2.6 KiB
Markdown
93 lines
2.6 KiB
Markdown
<br/>
|
||
|
||
<p align="center">
|
||
<a href="https://github.com/synphonyte/leptos-use">
|
||
<img src="https://raw.githubusercontent.com/synphonyte/leptos-use/main/docs/logo.svg" alt="Leptos-Use – Collection of essential Leptos utilities" width="150"/>
|
||
</a>
|
||
</p>
|
||
|
||
<h4 align="center">Collection of essential Leptos utilities</h4>
|
||
<p align="center">Inspired by React-Use / VueUse / SolidJS-USE</p>
|
||
|
||
<p align="center">
|
||
<a href="https://crates.io/crates/leptos-use"><img src="https://img.shields.io/crates/v/leptos-use.svg?label=&color=%232C1275" alt="Crates.io"/></a>
|
||
<a href="https://leptos-use.rs/server_side_rendering.html"><img src="https://img.shields.io/badge/-SSR-%236a214b" alt="SSR"></a>
|
||
<a href="https://leptos-use.rs"><img src="https://img.shields.io/badge/-docs%20%26%20demos-%239A233F" alt="Docs & Demos"></a>
|
||
<a href="https://leptos-use.rs"><img src="https://img.shields.io/badge/-44%20functions-%23EF3939" alt="44 Functions" /></a>
|
||
</p>
|
||
|
||
<br/>
|
||
<br/>
|
||
<br/>
|
||
|
||
|
||
## Usage
|
||
|
||
[](https://docs.rs/leptos-use/)
|
||
[](https://github.com/synphonyte/leptos-use#license)
|
||
[](https://github.com/synphonyte/leptos-use/actions/workflows/ci.yml)
|
||
|
||
```rust
|
||
use leptos::*;
|
||
use leptos_use::{use_mouse, UseMouseReturn};
|
||
|
||
#[component]
|
||
fn Demo(cx: Scope) -> impl IntoView {
|
||
let UseMouseReturn { x, y, .. } = use_mouse(cx);
|
||
|
||
view! { cx,
|
||
{x} " x " {y}
|
||
}
|
||
}
|
||
```
|
||
|
||
We have only just begun implementing the first dozen functions but they are already very usable and ergonomic.
|
||
|
||
Missing a function? Open a ticket or PR!
|
||
|
||
## Development
|
||
|
||
To run all tests run
|
||
|
||
```shell
|
||
cargo test --all-features
|
||
```
|
||
|
||
## Book
|
||
|
||
First you need to install
|
||
|
||
```shell
|
||
cargo install mdbook mdbook-cmdrun trunk
|
||
```
|
||
|
||
To build the book go in your terminal into the docs/book folder
|
||
and run
|
||
|
||
```shell
|
||
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
|
||
|
||
```shell
|
||
python3 post_build.py
|
||
```
|
||
|
||
If you only want to add the example for one function you can run for example
|
||
|
||
```shell
|
||
python3 post_build.py use_mequery
|
||
```
|
||
|
||
### New Function Template
|
||
|
||
To scaffold a new function quickly you can run `template/createfn.sh`. It requires that [`ffizer`](https://ffizer.github.io/) is installed.
|
||
|
||
## Leptos compatibility
|
||
|
||
| Crate version | Compatible Leptos version |
|
||
|---------------|---------------------------|
|
||
| <= 0.3 | 0.3 |
|
||
| 0.4, 0.5 | 0.4 |
|