maple_core/
internal.rs

1//! Internal DOM manipulation utilities. Generated by the `template!` macro. Should not be used directly.
2//! Internal APIs can be changed at any time without a major release.
3
4use std::cell::RefCell;
5use std::fmt;
6use std::rc::Rc;
7
8use wasm_bindgen::{prelude::*, JsCast};
9use web_sys::{DocumentFragment, Element, Event, Node};
10
11use crate::prelude::*;
12
13/// Create a new [`Element`] with the specified tag.
14pub fn element(tag: &str) -> Element {
15    web_sys::window()
16        .unwrap()
17        .document()
18        .unwrap()
19        .create_element(tag)
20        .unwrap()
21        .dyn_into()
22        .unwrap()
23}
24
25pub fn fragment() -> DocumentFragment {
26    web_sys::window()
27        .unwrap()
28        .document()
29        .unwrap()
30        .create_document_fragment()
31}
32
33/// Sets an attribute on an [`Element`].
34pub fn attr(element: &Element, name: &str, value: Box<dyn Fn() -> String>) {
35    let element = element.clone();
36    let name = name.to_string();
37    create_effect(move || {
38        element.set_attribute(&name, &value()).unwrap();
39    })
40}
41
42type EventListener = dyn Fn(Event);
43
44thread_local! {
45    /// A global event listener pool to prevent [`Closure`]s from being deallocated.
46    /// TODO: remove events when elements are detached.
47    static EVENT_LISTENERS: RefCell<Vec<Closure<EventListener>>> = RefCell::new(Vec::new());
48}
49
50/// Sets an event listener on an [`Element`].
51pub fn event(element: &Element, name: &str, handler: Box<EventListener>) {
52    let closure = Closure::wrap(handler);
53    element
54        .add_event_listener_with_callback(name, closure.as_ref().unchecked_ref())
55        .unwrap();
56
57    EVENT_LISTENERS.with(|event_listeners| event_listeners.borrow_mut().push(closure));
58}
59
60/// Appends a child node to an element.
61pub fn append(element: &dyn AsRef<Node>, child: &dyn AsRef<Node>) {
62    element.as_ref().append_child(child.as_ref()).unwrap();
63}
64
65/// Appends a [`dyn Render`](Render) to the `parent` node.
66/// Node is created inside an effect with [`Render::update_node`].
67pub fn append_render(parent: &dyn AsRef<Node>, child: Box<dyn Fn() -> Box<dyn Render>>) {
68    let parent = parent.as_ref().clone();
69
70    let node = create_effect_initial(cloned!((parent) => move || {
71        let node = RefCell::new(child().render());
72
73        let effect = cloned!((node) => move || {
74            let new_node = child().update_node(&parent, &node.borrow());
75            *node.borrow_mut() = new_node;
76        });
77
78        (Rc::new(effect), node)
79    }));
80
81    parent.append_child(&node.borrow()).unwrap();
82}
83
84/// Appends a static text node to the `parent` node.
85pub fn append_static_text(parent: &dyn AsRef<Node>, text: &dyn fmt::Display) {
86    let text_node = web_sys::window()
87        .unwrap()
88        .document()
89        .unwrap()
90        .create_text_node(&format!("{}", text));
91
92    parent.as_ref().append_child(&text_node).unwrap();
93}
94
95/// Sets the value of a [`NodeRef`].
96pub fn set_noderef(node: &dyn AsRef<Node>, noderef: NodeRef) {
97    noderef.set(node.as_ref().clone());
98}
maple_core/internal.rs

maple_core/
internal.rs
