use std::sync::Arc; use crate::contexts::router::RoutingCallback; use crate::history::HistoryProvider; use crate::routable::Routable; use dioxus_lib::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::*; /// # #[component] /// # fn Index() -> 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() -> Element, pub(crate) history: Option>, pub(crate) on_update: Option>, pub(crate) initial_route: 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(not(feature = "liveview"), target_arch = "wasm32", feature = "web"))] let history = Box::>::default(); #[cfg(all( not(feature = "liveview"), any(not(target_arch = "wasm32"), not(feature = "web")) ))] let history = Box::>::default(); #[cfg(feature = "liveview")] 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, initial_route: 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(|| { #[allow(unused)] let initial_route = self.initial_route.clone().unwrap_or("/".parse().unwrap_or_else(|err| panic!("index route does not exist:\n{}\n use MemoryHistory::with_initial_path or RouterConfig::initial_route to set a custom path", err) )); // If we are on wasm32 and the web feature is enabled, use the web history. #[cfg(all(target_arch = "wasm32", feature = "web"))] let history = Box::>>::default(); // If we are not on wasm32 and the liveview feature is enabled, use the liveview history. #[cfg(all(feature = "liveview", not(target_arch = "wasm32")))] let history = Box::new(AnyHistoryProviderImplWrapper::new(LiveviewHistory::new(initial_route))); // If neither of the above are true, use the memory history. #[cfg(all( not(all(target_arch = "wasm32", feature = "web")), not(all(feature = "liveview", not(target_arch = "wasm32"))), ))] let history = Box::new(AnyHistoryProviderImplWrapper::new(MemoryHistory::with_initial_path(initial_route))); 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 different history provider depending on the target platform. pub fn history(self, history: impl HistoryProvider + 'static) -> Self { Self { history: Some(Box::new(AnyHistoryProviderImplWrapper::new(history))), ..self } } /// The initial route the router should use if no history provider is set. pub fn initial_route(self, route: R) -> Self { Self { initial_route: Some(route), ..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() -> Element) -> Self { Self { failure_external_navigation: component, ..self } } }