ribir_core 0.4.0-alpha.55

A non-intrusive declarative GUI framework, to build modern native/wasm cross-platform applications.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

use std::cell::RefCell;

use crate::prelude::*;

class_names! {
  #[doc = "Class name for the tooltips"]
  TOOLTIPS,
}
/// Adds tooltip behavior to a widget declarer.
///
/// This built-in `FatObj` field attaches a `Tooltips` overlay that shows
/// when the host is hovered.
///
/// # Example
///
/// Hover the text to show a tooltip.
///
/// ```rust no_run
/// use ribir::prelude::*;
///
/// text! {
///   text: "Hover me",
///   tooltips: "I'm a tooltip!",
/// };
/// ```
#[derive(Default)]
pub struct Tooltips {
  pub tooltips: CowArc<str>,

  overlay: RefCell<Option<Overlay>>,
}

impl Declare for Tooltips {
  type Builder = FatObj<()>;
  fn declarer() -> Self::Builder { FatObj::new(()) }
}

impl Tooltips {
  pub fn show(&self, wnd: Rc<Window>) {
    if let Some(overlay) = self.overlay.borrow().clone()
      && !overlay.is_showing()
    {
      overlay.show(wnd);
    }
  }

  pub fn hidden(&self) {
    if let Some(overlay) = self.overlay.borrow().clone()
      && overlay.is_showing()
    {
      overlay.close();
    }
  }
}

impl<'c> ComposeChild<'c> for Tooltips {
  type Child = Widget<'c>;
  fn compose_child(this: impl StateWriter<Value = Self>, child: Self::Child) -> Widget<'c> {
    let mut child = FatObj::new(child);

    let content = text! {
      text: pipe!($read(this).tooltips.clone()),
      class: TOOLTIPS,
      global_anchor_x: {
        let track_id = $clone(child.track_id());
        GlobalAnchorX::center_align_to(track_id).always_follow()
      },
      global_anchor_y: {
        let track_id = $clone(child.track_id());
        let height = *$read(child.layout_height());
        GlobalAnchorY::bottom_align_to(track_id).offset(height).always_follow()
      },
    };
    *this.read().overlay.borrow_mut() = Some(Overlay::new(
      content,
      OverlayStyle { auto_close_policy: AutoClosePolicy::NOT_AUTO_CLOSE, mask: None },
    ));

    fn_widget! {
      let wnd = BuildCtx::get().window();
      let u = watch!(*$read(child.is_hovered()))
        .delay(Duration::from_millis(50))
        .distinct_until_changed()
        .subscribe(move |_| {
          if *$read(child.is_hovered()) {
            $read(this).show(wnd.clone());
          } else {
            $read(this).hidden();
          }
        });

      child.on_disposed(move |_| {
        u.unsubscribe();
        $read(this).hidden();
      });

      child
    }
    .into_widget()
  }
}