yew_hooks/hooks/use_interval.rs
1use gloo::timers::callback::Interval;
2use yew::prelude::*;
3
4use super::use_mut_latest;
5
6/// A hook that schedules an interval to invoke `callback` every `millis` milliseconds.
7/// The interval will be cancelled if `millis` is set to 0.
8///
9/// # Example
10///
11/// ```rust
12/// # use yew::prelude::*;
13/// #
14/// use yew_hooks::prelude::*;
15///
16/// #[function_component(Interval)]
17/// fn interval() -> Html {
18/// let state = use_state(|| 0);
19///
20/// {
21/// let state = state.clone();
22/// use_interval(move || {
23/// state.set(*state + 1);
24/// }, 2000);
25/// }
26///
27/// html! {
28/// <>
29/// { *state }
30/// </>
31/// }
32/// }
33/// ```
34#[hook]
35pub fn use_interval<Callback>(callback: Callback, millis: u32)
36where
37 Callback: FnMut() + 'static,
38{
39 let callback_ref = use_mut_latest(callback);
40 let interval_ref = use_mut_ref(|| None);
41
42 use_effect_with(millis, move |millis| {
43 if *millis > 0 {
44 *interval_ref.borrow_mut() = Some(Interval::new(*millis, move || {
45 let callback_ref = callback_ref.current();
46 let callback = &mut *callback_ref.borrow_mut();
47 callback();
48 }));
49 } else {
50 *interval_ref.borrow_mut() = None;
51 }
52
53 move || *interval_ref.borrow_mut() = None
54 });
55}