react-sys 1.0.0-alpha.23

React bindings for rust
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

#[cfg(feature = "import-react")]
macro_rules! wasm_bindgen_react_state_helpers {
    ($($b:item)+) => {
        #[wasm_bindgen(module = "/helpers/use-state-import.js")]
        extern "C" {
            $($b)+
        }
    };
}

#[cfg(not(feature = "import-react"))]
macro_rules! wasm_bindgen_react_state_helpers {
    ($($b:item)+) => {
        #[wasm_bindgen(module = "/helpers/use-state.js")]
        extern "C" {
            $($b)+
        }
    };
}

macro_rules! define_react_use_state_for_type {
    ( { value: $type_value:ty, $($t:tt)+ } ) => {
        define_react_use_state_for_type! {{
            input: $type_value,
            output: $type_value,
            $($t)+
        }}
    };
    ({
        input: $type_input:ty,
        output: $type_output:ty,
        object: $name_object:ident,
        setter: $name_setter:ident,
        use_state: $name_use:ident,
        use_state_with: $name_use_with:ident,
        auto_clean: $name_clean:ident,
        auto_clean_with: $name_clean_with:ident
        $(,)?
    }) => {
        wasm_bindgen_react_state_helpers! {
            #[derive(Debug, Clone)]
            pub type $name_object;
            #[wasm_bindgen(structural, method, getter)]
            pub fn value(this: &$name_object) -> $type_output;
            #[wasm_bindgen(structural, method, getter)]
            pub fn setter(this: &$name_object) -> $name_setter;

            #[derive(Debug, Clone)]
            pub type $name_setter;
            #[wasm_bindgen(structural, method)]
            pub fn set_state(this: &$name_setter, value: $type_input);
            /// Closure `get_value_from_old` will be called immediately,
            /// thus it is safe to use reference here
            ///
            /// Closure get_value_from_old will be called only once
            #[wasm_bindgen(structural, method, js_name = "set_state")]
            pub fn set_state_with(
                this: &$name_setter,
                get_value_from_old: &mut dyn FnMut($type_output) -> $type_input,
            );

            /// `React.useState<T>(initial_value)`
            #[wasm_bindgen(js_name = "use_state_object")]
            pub fn $name_use(initial_value: $type_input) -> $name_object;

            /// `React.useState<T>(get_initial_value)`
            #[wasm_bindgen(js_name = "use_state_object")]
            #[doc = concat!("React.useState<`", stringify!($type_input), "`>(initial_value)")]
            pub fn $name_use_with(
                initial_value: &mut dyn FnMut() -> $type_input,
            ) -> $name_object;

            #[wasm_bindgen(js_name = "use_state_auto_clean")]
            pub fn $name_clean(
                initial_value: $type_input,
                free: &Closure<dyn FnMut($type_output)>,
            ) -> $name_object;

            #[wasm_bindgen(js_name = "use_state_auto_clean")]
            pub fn $name_clean_with(
                get_initial_value: &mut dyn FnMut() -> $type_input,
                free: &Closure<dyn FnMut($type_output)>,
            ) -> $name_object;
        }
    };
}

macro_rules! define_react_use_state_helpers {
    ($($t:tt),+ $(,)?) => {
        $( define_react_use_state_for_type!{ $t } )+
    };
}

pub(super) use define_react_use_state_for_type;
pub(super) use define_react_use_state_helpers;
pub(super) use wasm_bindgen_react_state_helpers;