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}