Skip to main content

light_fw_core/reactive/
watch.rs

1//! Наблюдатель — подписка на изменение реактивных свойств.
2
3use std::rc::Rc;
4
5use super::observer::{self, EffectId};
6
7/// Подписка ([`watch`]), переживающая до [`stop`](Self::stop) или удаления.
8///
9/// Чтения, выполненные обработчиком, запоминаются автоматически: при изменении
10/// любого из свойств обработчик выполняется заново.
11pub struct Watcher {
12    id: EffectId,
13    stopped: bool,
14}
15
16impl Watcher {
17    /// Идентификатор эффекта наблюдателя.
18    pub fn id(&self) -> EffectId {
19        self.id
20    }
21
22    /// Отписывает обработчик и удаляет его зависимости.
23    pub fn stop(&mut self) {
24        if !self.stopped {
25            self.stopped = true;
26            observer::remove_effect(self.id);
27        }
28    }
29}
30
31impl Drop for Watcher {
32    fn drop(&mut self) {
33        self.stop();
34    }
35}
36
37/// Создаёт наблюдателя (аналог `watchEffect` в Vue): выполняет `f` один раз,
38/// запоминает прочитанные свойства и повторяет `f` при их изменении.
39///
40/// ```no_run
41/// # extern crate light_fw_core as light;
42/// use light::prelude::*;
43///
44/// #[proxy]
45/// struct Counter {
46///     count: i64,
47/// }
48///
49/// fn main() {
50///     let counter = Counter::new();
51///     let _watcher = watch({
52///         let counter = counter.clone();
53///         move || println!("count = {}", counter.count())
54///     });
55///     counter.set_count(1);
56/// }
57/// ```
58pub fn watch(f: impl Fn() + 'static) -> Watcher {
59    let callback: Rc<dyn Fn()> = Rc::new(f);
60    let id = observer::register_watcher(Rc::clone(&callback));
61    observer::with_effect(id, move || callback());
62    Watcher { id, stopped: false }
63}