Struct RouterConfig

pub struct RouterConfig<R> { /* private fields */ }

Global configuration options for the router.

This implements Default and follows the builder pattern, so you can use it like this:

#[derive(Clone, Routable)]
enum Route {
    #[route("/")]
    Index {},
}

fn ExternalNavigationFailure() -> Element {
    rsx! {
        "Failed to navigate to external URL"
    }
}

let cfg = RouterConfig::<Route>::default().failure_external_navigation(ExternalNavigationFailure);

Implementations

impl<R> RouterConfig<R>

where R: Routable, <R as FromStr>::Err: Display,

pub fn on_update( self, callback: impl Fn(GenericRouterContext<R>) -> Option<NavigationTarget<R>> + 'static, ) -> Self

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 failure_external_navigation(self, component: fn() -> Element) -> Self

A component to render when an external navigation fails.

Defaults to a router-internal component called FailureExternalNavigation

Trait Implementations

impl<R> Default for RouterConfig<R>

fn default() -> Self

Returns the “default value” for a type.