use std::sync::Arc; use crate::contexts::router::RoutingCallback; use crate::history::HistoryProvider; use crate::routable::Routable; use dioxus::prelude::*; use crate::prelude::*; /// Global configuration options for the router. /// /// This implements [`Default`] and follows the builder pattern, so you can use it like this: /// ```rust,no_run /// # use dioxus_router::prelude::*; /// # use dioxus::prelude::*; /// # #[inline_props] /// # fn Index(cx: Scope) -> Element { /// # todo!() /// # } /// #[derive(Clone, Routable)] /// enum Route { /// #[route("/")] /// Index {}, /// } /// let cfg = RouterConfig::default().history(WebHistory::::default()); /// ``` pub struct RouterConfig { pub(crate) failure_external_navigation: fn(Scope) -> Element, pub(crate) history: Option>, pub(crate) on_update: Option>, } #[cfg(feature = "serde")] impl Default for RouterConfig where ::Err: std::fmt::Display, R: serde::Serialize + serde::de::DeserializeOwned, { fn default() -> Self { Self { failure_external_navigation: FailureExternalNavigation::, history: None, on_update: None, } } } #[cfg(feature = "serde")] impl RouterConfig where ::Err: std::fmt::Display, R: serde::Serialize + serde::de::DeserializeOwned, { pub(crate) fn get_history(self) -> Box> { self.history.unwrap_or_else(|| { #[cfg(all(target_arch = "wasm32", feature = "web"))] let history = Box::>::default(); #[cfg(not(all(target_arch = "wasm32", feature = "web")))] let history = Box::>::default(); history }) } } #[cfg(not(feature = "serde"))] impl Default for RouterConfig where ::Err: std::fmt::Display, { fn default() -> Self { Self { failure_external_navigation: FailureExternalNavigation, history: None, on_update: None, } } } #[cfg(not(feature = "serde"))] impl RouterConfig where ::Err: std::fmt::Display, { pub(crate) fn take_history(&mut self) -> Box { self.history.take().unwrap_or_else(|| { #[cfg(all(target_arch = "wasm32", feature = "web"))] let history = Box::>>::default(); #[cfg(not(all(target_arch = "wasm32", feature = "web")))] let history = Box::>>::default(); history }) } } impl RouterConfig where R: Routable, ::Err: std::fmt::Display, { /// A function to be called whenever the routing is updated. /// /// The callback is invoked after the routing is updated, but before components and hooks are /// updated. /// /// If the callback returns a [`NavigationTarget`] the router will replace the current location /// with it. If no navigation failure was triggered, the router will then updated dependent /// components and hooks. /// /// The callback is called no more than once per rerouting. It will not be called if a /// navigation failure occurs. /// /// Defaults to [`None`]. pub fn on_update( self, callback: impl Fn(GenericRouterContext) -> Option> + 'static, ) -> Self { Self { on_update: Some(Arc::new(callback)), ..self } } /// The [`HistoryProvider`] the router should use. /// /// Defaults to a default [`MemoryHistory`]. pub fn history(self, history: impl HistoryProvider + 'static) -> Self { Self { history: Some(Box::new(AnyHistoryProviderImplWrapper::new(history))), ..self } } /// A component to render when an external navigation fails. /// /// Defaults to a router-internal component called [`FailureExternalNavigation`] pub fn failure_external_navigation(self, component: fn(Scope) -> Element) -> Self { Self { failure_external_navigation: component, ..self } } }