use crate::arena::ElementRef; use crate::innerlude::{DirtyTasks, Effect}; use crate::nodes::VNodeMount; use crate::scope_context::SuspenseLocation; use crate::{ innerlude::{LocalTask, SchedulerMsg}, scope_context::Scope, scopes::ScopeId, Task, }; use crate::{AttributeValue, ElementId, Event}; use slab::Slab; use slotmap::DefaultKey; use std::any::Any; use std::collections::BTreeSet; use std::fmt; use std::{ cell::{Cell, Ref, RefCell}, rc::Rc, }; use tracing::instrument; thread_local! { static RUNTIMES: RefCell>> = const { RefCell::new(vec![]) }; } /// A global runtime that is shared across all scopes that provides the async runtime and context API pub struct Runtime { pub(crate) scope_states: RefCell>>, // We use this to track the current scope // This stack should only be modified through [`Runtime::with_scope_on_stack`] to ensure that the stack is correctly restored scope_stack: RefCell>, // We use this to track the current suspense location. Generally this lines up with the scope stack, but it may be different for children of a suspense boundary // This stack should only be modified through [`Runtime::with_suspense_location`] to ensure that the stack is correctly restored suspense_stack: RefCell>, // We use this to track the current task pub(crate) current_task: Cell>, /// Tasks created with cx.spawn pub(crate) tasks: RefCell>>, // Currently suspended tasks pub(crate) suspended_tasks: Cell, pub(crate) rendering: Cell, pub(crate) sender: futures_channel::mpsc::UnboundedSender, // The effects that need to be run after the next render pub(crate) pending_effects: RefCell>, // Tasks that are waiting to be polled pub(crate) dirty_tasks: RefCell>, // The element ids that are used in the renderer // These mark a specific place in a whole rsx block pub(crate) elements: RefCell>>, // Once nodes are mounted, the information about where they are mounted is stored here // We need to store this information on the virtual dom so that we know what nodes are mounted where when we bubble events // Each mount is associated with a whole rsx block. [`VirtualDom::elements`] link to a specific node in the block pub(crate) mounts: RefCell>, } impl Runtime { pub(crate) fn new(sender: futures_channel::mpsc::UnboundedSender) -> Rc { let mut elements = Slab::default(); // the root element is always given element ID 0 since it's the container for the entire tree elements.insert(None); Rc::new(Self { sender, rendering: Cell::new(true), scope_states: Default::default(), scope_stack: Default::default(), suspense_stack: Default::default(), current_task: Default::default(), tasks: Default::default(), suspended_tasks: Default::default(), pending_effects: Default::default(), dirty_tasks: Default::default(), elements: RefCell::new(elements), mounts: Default::default(), }) } /// Get the current runtime pub fn current() -> Result, RuntimeError> { RUNTIMES .with(|stack| stack.borrow().last().cloned()) .ok_or(RuntimeError::new()) } /// Create a scope context. This slab is synchronized with the scope slab. pub(crate) fn create_scope(&self, context: Scope) { let id = context.id; let mut scopes = self.scope_states.borrow_mut(); if scopes.len() <= id.0 { scopes.resize_with(id.0 + 1, Default::default); } scopes[id.0] = Some(context); } pub(crate) fn remove_scope(self: &Rc, id: ScopeId) { { let borrow = self.scope_states.borrow(); if let Some(scope) = &borrow[id.0] { // Manually drop tasks, hooks, and contexts inside of the runtime self.on_scope(id, || { // Drop all spawned tasks - order doesn't matter since tasks don't rely on eachother // In theory nested tasks might not like this for id in scope.spawned_tasks.take() { self.remove_task(id); } // Drop all hooks in reverse order in case a hook depends on another hook. for hook in scope.hooks.take().drain(..).rev() { drop(hook); } // Drop all contexts scope.shared_contexts.take(); }); } } self.scope_states.borrow_mut()[id.0].take(); } /// Get the current scope id pub(crate) fn current_scope_id(&self) -> Result { self.scope_stack .borrow() .last() .copied() .ok_or(RuntimeError { _priv: () }) } /// Call this function with the current scope set to the given scope /// /// Useful in a limited number of scenarios pub fn on_scope(self: &Rc, id: ScopeId, f: impl FnOnce() -> O) -> O { let _runtime_guard = RuntimeGuard::new(self.clone()); { self.push_scope(id); } let o = f(); { self.pop_scope(); } o } /// Get the current suspense location pub(crate) fn current_suspense_location(&self) -> Option { self.suspense_stack.borrow().last().cloned() } /// Run a callback a [`SuspenseLocation`] at the top of the stack pub(crate) fn with_suspense_location( &self, suspense_location: SuspenseLocation, f: impl FnOnce() -> O, ) -> O { self.suspense_stack.borrow_mut().push(suspense_location); let o = f(); self.suspense_stack.borrow_mut().pop(); o } /// Run a callback with the current scope at the top of the stack pub(crate) fn with_scope_on_stack(&self, scope: ScopeId, f: impl FnOnce() -> O) -> O { self.push_scope(scope); let o = f(); self.pop_scope(); o } /// Push a scope onto the stack fn push_scope(&self, scope: ScopeId) { let suspense_location = self .scope_states .borrow() .get(scope.0) .and_then(|s| s.as_ref()) .map(|s| s.suspense_location()) .unwrap_or_default(); self.suspense_stack.borrow_mut().push(suspense_location); self.scope_stack.borrow_mut().push(scope); } /// Pop a scope off the stack fn pop_scope(&self) { self.scope_stack.borrow_mut().pop(); self.suspense_stack.borrow_mut().pop(); } /// Get the state for any scope given its ID /// /// This is useful for inserting or removing contexts from a scope, or rendering out its root node pub(crate) fn get_state(&self, id: ScopeId) -> Option> { Ref::filter_map(self.scope_states.borrow(), |contexts| { contexts.get(id.0).and_then(|f| f.as_ref()) }) .ok() } /// Pushes a new scope onto the stack pub(crate) fn push(runtime: Rc) { RUNTIMES.with(|stack| stack.borrow_mut().push(runtime)); } /// Pops a scope off the stack pub(crate) fn pop() { RUNTIMES.with(|stack| stack.borrow_mut().pop()); } /// Runs a function with the current runtime pub(crate) fn with(f: impl FnOnce(&Runtime) -> R) -> Result { Self::current().map(|r| f(&r)) } /// Runs a function with the current scope pub(crate) fn with_current_scope(f: impl FnOnce(&Scope) -> R) -> Result { Self::with(|rt| { rt.current_scope_id() .ok() .and_then(|scope| rt.get_state(scope).map(|sc| f(&sc))) }) .ok() .flatten() .ok_or(RuntimeError::new()) } /// Runs a function with the current scope pub(crate) fn with_scope( scope: ScopeId, f: impl FnOnce(&Scope) -> R, ) -> Result { Self::with(|rt| rt.get_state(scope).map(|sc| f(&sc))) .ok() .flatten() .ok_or(RuntimeError::new()) } /// Finish a render. This will mark all effects as ready to run and send the render signal. pub(crate) fn finish_render(&self) { // If there are new effects we can run, send a message to the scheduler to run them (after the renderer has applied the mutations) if !self.pending_effects.borrow().is_empty() { self.sender .unbounded_send(SchedulerMsg::EffectQueued) .expect("Scheduler should exist"); } } /// Check if we should render a scope pub(crate) fn scope_should_render(&self, scope_id: ScopeId) -> bool { // If there are no suspended futures, we know the scope is not and we can skip context checks if self.suspended_tasks.get() == 0 { return true; } // If this is not a suspended scope, and we are under a frozen context, then we should let scopes = self.scope_states.borrow(); let scope = &scopes[scope_id.0].as_ref().unwrap(); !matches!(scope.suspense_location(), SuspenseLocation::UnderSuspense(suspense) if suspense.is_suspended()) } /// Call a listener inside the VirtualDom with data from outside the VirtualDom. **The ElementId passed in must be the id of an element with a listener, not a static node or a text node.** /// /// This method will identify the appropriate element. The data must match up with the listener declared. Note that /// this method does not give any indication as to the success of the listener call. If the listener is not found, /// nothing will happen. /// /// It is up to the listeners themselves to mark nodes as dirty. /// /// If you have multiple events, you can call this method multiple times before calling "render_with_deadline" #[instrument(skip(self, event), level = "trace", name = "Runtime::handle_event")] pub fn handle_event(self: &Rc, name: &str, event: Event, element: ElementId) { let _runtime = RuntimeGuard::new(self.clone()); let elements = self.elements.borrow(); if let Some(Some(parent_path)) = elements.get(element.0).copied() { if event.propagates() { self.handle_bubbling_event(parent_path, name, event); } else { self.handle_non_bubbling_event(parent_path, name, event); } } } /* ------------------------ The algorithm works by walking through the list of dynamic attributes, checking their paths, and breaking when we find the target path. With the target path, we try and move up to the parent until there is no parent. Due to how bubbling works, we call the listeners before walking to the parent. If we wanted to do capturing, then we would accumulate all the listeners and call them in reverse order. ---------------------- For a visual demonstration, here we present a tree on the left and whether or not a listener is collected on the right. | <-- yes (is ascendant) | | | <-- no (is not direct ascendant) | | <-- yes (is ascendant) | | | | | <--- target element, break early, don't check other listeners | | | <-- no, broke early | <-- no, broke early */ #[instrument( skip(self, uievent), level = "trace", name = "VirtualDom::handle_bubbling_event" )] fn handle_bubbling_event(&self, parent: ElementRef, name: &str, uievent: Event) { let mounts = self.mounts.borrow(); // If the event bubbles, we traverse through the tree until we find the target element. // Loop through each dynamic attribute (in a depth first order) in this template before moving up to the template's parent. let mut parent = Some(parent); while let Some(path) = parent { let mut listeners = vec![]; let Some(mount) = mounts.get(path.mount.0) else { // If the node is suspended and not mounted, we can just ignore the event return; }; let el_ref = &mount.node; let node_template = el_ref.template; let target_path = path.path; // Accumulate listeners into the listener list bottom to top for (idx, this_path) in node_template.attr_paths.iter().enumerate() { let attrs = &*el_ref.dynamic_attrs[idx]; for attr in attrs.iter() { // Remove the "on" prefix if it exists, TODO, we should remove this and settle on one if attr.name.get(2..) == Some(name) && target_path.is_descendant(this_path) { listeners.push(&attr.value); // Break if this is the exact target element. // This means we won't call two listeners with the same name on the same element. This should be // documented, or be rejected from the rsx! macro outright if target_path == this_path { break; } } } } // Now that we've accumulated all the parent attributes for the target element, call them in reverse order // We check the bubble state between each call to see if the event has been stopped from bubbling tracing::event!( tracing::Level::TRACE, "Calling {} listeners", listeners.len() ); for listener in listeners.into_iter().rev() { if let AttributeValue::Listener(listener) = listener { self.rendering.set(false); listener.call(uievent.clone()); self.rendering.set(true); let metadata = uievent.metadata.borrow(); if !metadata.propagates { return; } } } let mount = el_ref.mount.get().as_usize(); parent = mount.and_then(|id| mounts.get(id).and_then(|el| el.parent)); } } /// Call an event listener in the simplest way possible without bubbling upwards #[instrument( skip(self, uievent), level = "trace", name = "VirtualDom::handle_non_bubbling_event" )] fn handle_non_bubbling_event(&self, node: ElementRef, name: &str, uievent: Event) { let mounts = self.mounts.borrow(); let Some(mount) = mounts.get(node.mount.0) else { // If the node is suspended and not mounted, we can just ignore the event return; }; let el_ref = &mount.node; let node_template = el_ref.template; let target_path = node.path; for (idx, this_path) in node_template.attr_paths.iter().enumerate() { let attrs = &*el_ref.dynamic_attrs[idx]; for attr in attrs.iter() { // Remove the "on" prefix if it exists, TODO, we should remove this and settle on one // Only call the listener if this is the exact target element. if attr.name.get(2..) == Some(name) && target_path == this_path { if let AttributeValue::Listener(listener) = &attr.value { self.rendering.set(false); listener.call(uievent.clone()); self.rendering.set(true); break; } } } } } } /// A guard for a new runtime. This must be used to override the current runtime when importing components from a dynamic library that has it's own runtime. /// /// ```rust /// use dioxus::prelude::*; /// /// fn main() { /// let virtual_dom = VirtualDom::new(app); /// } /// /// fn app() -> Element { /// rsx!{ Component { runtime: Runtime::current().unwrap() } } /// } /// /// // In a dynamic library /// #[derive(Props, Clone)] /// struct ComponentProps { /// runtime: std::rc::Rc, /// } /// /// impl PartialEq for ComponentProps { /// fn eq(&self, _other: &Self) -> bool { /// true /// } /// } /// /// fn Component(cx: ComponentProps) -> Element { /// use_hook(|| { /// let _guard = RuntimeGuard::new(cx.runtime.clone()); /// }); /// /// rsx! { div {} } /// } /// ``` pub struct RuntimeGuard(()); impl RuntimeGuard { /// Create a new runtime guard that sets the current Dioxus runtime. The runtime will be reset when the guard is dropped pub fn new(runtime: Rc) -> Self { Runtime::push(runtime); Self(()) } } impl Drop for RuntimeGuard { fn drop(&mut self) { Runtime::pop(); } } /// Missing Dioxus runtime error. pub struct RuntimeError { _priv: (), } impl RuntimeError { #[inline(always)] pub(crate) fn new() -> Self { Self { _priv: () } } } impl fmt::Debug for RuntimeError { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { f.debug_struct("RuntimeError").finish() } } impl fmt::Display for RuntimeError { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { write!( f, "Must be called from inside a Dioxus runtime. Help: Some APIs in dioxus require a global runtime to be present. If you are calling one of these APIs from outside of a dioxus runtime (typically in a web-sys closure or dynamic library), you will need to grab the runtime from a scope that has it and then move it into your new scope with a runtime guard. For example, if you are trying to use dioxus apis from a web-sys closure, you can grab the runtime from the scope it is created in: ```rust use dioxus::prelude::*; static COUNT: GlobalSignal = Signal::global(|| 0); #[component] fn MyComponent() -> Element {{ use_effect(|| {{ // Grab the runtime from the MyComponent scope let runtime = Runtime::current().expect(\"Components run in the Dioxus runtime\"); // Move the runtime into the web-sys closure scope let web_sys_closure = Closure::new(|| {{ // Then create a guard to provide the runtime to the closure let _guard = RuntimeGuard::new(runtime); // and run whatever code needs the runtime tracing::info!(\"The count is: {{COUNT}}\"); }}); }}) }} ```" ) } } impl std::error::Error for RuntimeError {}