Subtree memorization / reactive templates (#488)

This commit adds subtree memoization to Dioxus.

Subtree memoization is basically a compile-time step that drastically 
reduces the amount of work the diffing engine needs to do at runtime by
extracting non-changing nodes out into a static "template." Templates 
are then understood by the various renderers in the ecosystem as a 
faster way of rendering the same items. 

For example, in the web, templates are simply a set of DOM Nodes created 
once and then cloned later. This is the same pattern frameworks like Lithtml
and SolidJS use to achieve near-perfect performance. 

Subtree memoization adds an additional level of complexity to Dioxus. The RSX
macro needs to be much smarter to identify changing/nonchanging nodes and
generate a mapping between the Template and its runtime counterparts.

This commit represents a working starter point for this work, adding support 
for templates for the web, desktop, liveview, ssr, and native-core renderers.
In the future we will try to shrink code generation, generally improve 
performance, and simplify our implementation.
This commit is contained in:
Demonthos authored and GitHub committed 2022-09-30 12:03:06 -07:00
1 parent b32fd2d2cd
commit 047ed1e553
80 files changed
+6774 -2552

No files matched your search

+39 -6
View File
@@ -13,17 +13,25 @@
#[macro_use]
mod errors;
#[cfg(any(feature = "hot-reload", debug_assertions))]
mod attributes;
mod component;
mod element;
#[cfg(any(feature = "hot-reload", debug_assertions))]
mod elements;
#[cfg(any(feature = "hot-reload", debug_assertions))]
mod error;
mod ifmt;
mod node;
mod template;
// Re-export the namespaces into each other
pub use component::*;
pub use element::*;
pub use ifmt::*;
pub use node::*;
#[cfg(any(feature = "hot-reload", debug_assertions))]
pub use template::{try_parse_template, DynamicTemplateContextBuilder};
// imports
use proc_macro2::TokenStream as TokenStream2;
@@ -32,6 +40,7 @@ use syn::{
parse::{Parse, ParseStream},
Result, Token,
};
use template::TemplateBuilder;
pub struct CallBody {
pub roots: Vec<BodyNode>,
@@ -58,12 +67,17 @@ impl Parse for CallBody {
/// Serialize the same way, regardless of flavor
impl ToTokens for CallBody {
fn to_tokens(&self, out_tokens: &mut TokenStream2) {
let inner = if self.roots.len() == 1 {
let inner = &self.roots[0];
quote! { #inner }
let template = TemplateBuilder::from_roots(self.roots.clone());
let inner = if let Some(template) = template {
quote! { #template }
} else {
let childs = &self.roots;
quote! { __cx.fragment_root([ #(#childs),* ]) }
let children = &self.roots;
if children.len() == 1 {
let inner = &self.roots[0];
quote! { #inner }
} else {
quote! { __cx.fragment_root([ #(#children),* ]) }
}
};
// Otherwise we just build the LazyNode wrapper
@@ -75,3 +89,22 @@ impl ToTokens for CallBody {
})
}
}
impl CallBody {
pub fn to_tokens_without_template(&self, out_tokens: &mut TokenStream2) {
let children = &self.roots;
let inner = if children.len() == 1 {
let inner = &self.roots[0];
quote! { #inner }
} else {
quote! { __cx.fragment_root([ #(#children),* ]) }
};
out_tokens.append_all(quote! {
LazyNodes::new(move |__cx: NodeFactory| -> VNode {
use dioxus_elements::{GlobalAttributes, SvgAttributes};
#inner
})
})
}
}