Jonathan Kelley
7d490dc3bd
* feat: integrate dioxus-logger inline * remove log/simple logger references * fix: add dioxus-data-id-0 to root elements to not emit errors internally * drop config.toml and use cargo.toml profiles instead * make clippy happy with the unit value lint * feat: better presentation for logging
80 lines
2.3 KiB
Rust
80 lines
2.3 KiB
Rust
use dioxus_core::LaunchConfig;
|
|
use wasm_bindgen::JsCast as _;
|
|
|
|
/// Configuration for the WebSys renderer for the Dioxus VirtualDOM.
|
|
///
|
|
/// This struct helps configure the specifics of hydration and render destination for WebSys.
|
|
///
|
|
/// # Example
|
|
///
|
|
/// ```rust, ignore
|
|
/// dioxus_web::launch(App, Config::new().hydrate(true).root_name("myroot"))
|
|
/// ```
|
|
pub struct Config {
|
|
pub(crate) hydrate: bool,
|
|
pub(crate) root: ConfigRoot,
|
|
}
|
|
|
|
impl LaunchConfig for Config {}
|
|
|
|
pub(crate) enum ConfigRoot {
|
|
RootName(String),
|
|
RootNode(web_sys::Node),
|
|
}
|
|
|
|
impl Config {
|
|
/// Create a new Default instance of the Config.
|
|
///
|
|
/// This is no different than calling `Config::default()`
|
|
pub fn new() -> Self {
|
|
Self::default()
|
|
}
|
|
|
|
#[cfg(feature = "hydrate")]
|
|
/// Enable SSR hydration
|
|
///
|
|
/// This enables Dioxus to pick up work from a pre-rendered HTML file. Hydration will completely skip over any async
|
|
/// work and suspended nodes.
|
|
///
|
|
/// Dioxus will load up all the elements with the `dio_el` data attribute into memory when the page is loaded.
|
|
pub fn hydrate(mut self, f: bool) -> Self {
|
|
self.hydrate = f;
|
|
self
|
|
}
|
|
|
|
/// Set the name of the element that Dioxus will use as the root.
|
|
///
|
|
/// This is akin to calling React.render() on the element with the specified name.
|
|
/// Note that this only works on the current document, i.e. `window.document`.
|
|
/// To use a different document (popup, iframe, ...) use [Self::rootelement] instead.
|
|
pub fn rootname(mut self, name: impl Into<String>) -> Self {
|
|
self.root = ConfigRoot::RootName(name.into());
|
|
self
|
|
}
|
|
|
|
/// Set the element that Dioxus will use as root.
|
|
///
|
|
/// This is akin to calling React.render() on the given element.
|
|
pub fn rootelement(mut self, elem: web_sys::Element) -> Self {
|
|
self.root = ConfigRoot::RootNode(elem.unchecked_into());
|
|
self
|
|
}
|
|
|
|
/// Set the node that Dioxus will use as root.
|
|
///
|
|
/// This is akin to calling React.render() on the given element.
|
|
pub fn rootnode(mut self, node: web_sys::Node) -> Self {
|
|
self.root = ConfigRoot::RootNode(node);
|
|
self
|
|
}
|
|
}
|
|
|
|
impl Default for Config {
|
|
fn default() -> Self {
|
|
Self {
|
|
hydrate: false,
|
|
root: ConfigRoot::RootName("main".to_string()),
|
|
}
|
|
}
|
|
}
|