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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

use crate::prelude::*;

/// Assigns a `CursorIcon` to a widget to control the pointer cursor while
/// hovering it.
///
/// This is a built-in `FatObj` field. Setting the `cursor` field attaches a
/// `Cursor` widget that updates the window cursor on pointer enter/leave.
///
/// # Example
///
/// Show a pointer cursor when hovering the text.
///
/// ```rust
/// use ribir::prelude::*;
///
/// text! {
///   cursor: CursorIcon::Pointer,
///   text: "Hover me!"
/// };
/// ```
#[derive(Default, Debug)]
pub struct Cursor {
  pub cursor: CursorIcon,
}

impl Declare for Cursor {
  type Builder = FatObj<()>;
  #[inline]
  fn declarer() -> Self::Builder { FatObj::new(()) }
}

impl<'c> ComposeChild<'c> for Cursor {
  type Child = Widget<'c>;
  fn compose_child(this: impl StateWriter<Value = Self>, child: Self::Child) -> Widget<'c> {
    fn_widget! {
      let save_cursor: Stateful<Option<CursorIcon>> = Stateful::new(None);
      let mut child = FatObj::new(child);
      @(child) {
        on_pointer_enter: move |e: &mut PointerEvent| {
          if e.point_type == PointerType::Mouse
            && e.mouse_buttons() == MouseButtons::empty()
          {
            let wnd = e.window();
            let old_cursor = *$read(save_cursor);
            if old_cursor != Some(wnd.get_cursor()) {
              *$write(save_cursor) = Some(wnd.get_cursor());
              wnd.set_cursor($read(this).cursor);
            }
          }
        },
        on_pointer_leave: move |e: &mut PointerEvent| {
          if let Some(cursor) = $write(save_cursor).take() {
            e.window().set_cursor(cursor);
          }
        },
        on_disposed: move |e| {
          if let Some(cursor) = $write(save_cursor).take() {
            e.window().set_cursor(cursor);
          }
        },
      }
    }
    .into_widget()
  }
}

#[cfg(test)]
mod tests {
  use super::*;
  use crate::{reset_test_env, test_helper::*};

  #[test]
  fn tree_down_up() {
    reset_test_env!();

    let row_tree = fn_widget! {
      @MockBox {
        size: Size::new(f32::INFINITY, f32::INFINITY),
        cursor: CursorIcon::AllScroll,
        @MockMulti{
          @MockBox {
            size: Size::new(200., 200.),
            cursor: CursorIcon::Pointer,
            @MockBox {
              size:  Size::new(100., 100.),
              cursor: CursorIcon::Help,
            }
          }
        }
      }
    };

    let wnd = TestWindow::from_widget(row_tree);

    wnd.draw_frame();

    wnd.process_cursor_move(Point::new(1., 1.));
    wnd.run_frame_tasks();
    assert_eq!(wnd.get_cursor(), CursorIcon::Help);

    wnd.process_cursor_move(Point::new(101., 1.));
    wnd.run_frame_tasks();
    assert_eq!(wnd.get_cursor(), CursorIcon::Pointer);

    wnd.process_cursor_move(Point::new(201., 1.));
    wnd.run_frame_tasks();
    assert_eq!(wnd.get_cursor(), CursorIcon::AllScroll);

    wnd.process_cursor_move(Point::new(101., 1.));
    wnd.run_frame_tasks();
    assert_eq!(wnd.get_cursor(), CursorIcon::Pointer);

    wnd.process_cursor_move(Point::new(1., 1.));
    wnd.run_frame_tasks();
    assert_eq!(wnd.get_cursor(), CursorIcon::Help);
  }
}