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

//! EventTarget is a DOM interface implemented by objects that can receive
//! events and may have listeners for them.

use crate::interfaces::node::NodeWrapper;
use augdom::event::{Event, EventHandle};
use moxie::cache_with;

/// EventTarget is a DOM interface implemented by objects that can receive
/// events and may have listeners for them.
///
/// Element, Document, and Window are the most common event targets, but other
/// objects can be event targets, too. For example XMLHttpRequest, AudioNode,
/// AudioContext, and others.
///
/// Many event targets (including elements, documents, and windows) also support
/// setting event handlers via onevent properties and attributes.
///
/// Note: this trait cannot be implemented outside of this crate.
pub trait EventTarget<Ev>: NodeWrapper
where
    Ev: 'static + Event,
{
    /// Declare an event handler on the element.
    ///
    /// A guard value is stored as a resulting "effect" of the mutation, and
    /// removes the attribute when `drop`ped, to ensure that the attribute
    /// is removed when this declaration is no longer referenced in the most
    /// recent (`moxie::Revision`).
    ///
    /// Currently this is performed on every Revision, as changes to event
    /// handlers don't typically affect the debugging experience and have
    /// not yet shown up in performance profiles.
    #[topo::nested]
    fn on(self, callback: impl FnMut(Ev) + 'static) -> Self {
        cache_with(
            &moxie::runtime::Revision::current(),
            |_| EventHandle::new(self.raw_node_that_has_sharp_edges_please_be_careful(), callback),
            |_| {},
        );
        self
    }
}