leptos_use/
signal_debounced.rs

1use crate::utils::{signal_filtered, signal_filtered_local};
2use crate::{use_debounce_fn_with_options, DebounceOptions};
3use leptos::prelude::*;
4use leptos::reactive::wrappers::read::Signal;
5
6signal_filtered!(
7    /// Debounce changing of a `Signal` value.
8    ///
9    /// Use `*_local` variants for values that are not `Send + Sync`.
10    ///
11    /// ## Demo
12    ///
13    /// [Link to Demo](https://github.com/Synphonyte/leptos-use/tree/main/examples/signal_debounced)
14    ///
15    /// ## Usage
16    ///
17    /// ```
18    /// # use leptos::prelude::*;
19    /// # use leptos_use::{signal_debounced, signal_debounced_local};
20    /// # use std::cell::RefCell;
21    /// #
22    /// # #[component]
23    /// # fn Demo() -> impl IntoView {
24    /// let (input, set_input) = signal("");
25    /// let debounced: Signal<&'static str> = signal_debounced(input, 1000.0);
26    ///
27    /// let (input_local, set_input_local) = signal_local(RefCell::new(0));
28    /// let debounced_local: Signal<RefCell<i32>, _> = signal_debounced_local(input_local, 1000.0);
29    /// #
30    /// # view! { }
31    /// # }
32    /// ```
33    ///
34    /// ### Options
35    ///
36    /// The usual debounce option `max_wait` is available.
37    ///
38    /// ```
39    /// # use leptos::prelude::*;
40    /// # use leptos_use::{signal_debounced_with_options, signal_debounced_local_with_options, DebounceOptions};
41    /// # use std::cell::RefCell;
42    /// #
43    /// # #[component]
44    /// # fn Demo() -> impl IntoView {
45    /// let (input, set_input) = signal("");
46    /// let debounced: Signal<&'static str> = signal_debounced_with_options(
47    ///     input,
48    ///     1000.0,
49    ///     DebounceOptions::default().max_wait(Some(500.0))
50    /// );
51    ///
52    /// let (input_local, set_input_local) = signal_local(RefCell::new(0));
53    /// let debounced_local: Signal<RefCell<i32>, _> = signal_debounced_local_with_options(
54    ///     input_local,
55    ///     1000.0,
56    ///     DebounceOptions::default().max_wait(Some(500.0))
57    /// );
58    /// #
59    /// # view! { }
60    /// # }
61    /// ```
62    ///
63    /// ## Recommended Reading
64    ///
65    /// - [**Debounce vs Throttle**: Definitive Visual Guide](https://redd.one/blog/debounce-vs-throttle)
66    /// - [Debouncing and Throttling Explained Through Examples](https://css-tricks.com/debouncing-throttling-explained-examples/)
67    ///
68    /// ## Server-Side Rendering
69    ///
70    /// Internally this uses `setTimeout` which is not supported on the server. So usually
71    /// a throttled signal on the server will simply be ignored.
72    debounce
73    /// [`signal_debounced`]
74    /// [`DebounceOptions`]
75);
76
77signal_filtered_local!(
78    /// Debounce changing of a `Signal` value that is not `Send + Sync`.
79    ///
80    /// See ['signal_debounced`] for docs.
81    debounce
82    /// [`signal_debounced_local`]
83    /// [`DebounceOptions`]
84);
leptos_use/signal_debounced.rs

leptos_use/
signal_debounced.rs
