You are currently viewing the docs for Dioxus 0.5.7 which is no longer maintained.

Programmatic Navigation

Sometimes we want our application to navigate to another page without having the

Using a Navigator

We can get a navigator with the navigator function which returns a Navigator.

We can use the Navigator to trigger four different kinds of navigation:

  • push will navigate to the target. It works like a regular anchor tag.
  • replace works like push, except that it replaces the current history entry
  • Go back works like the browser's back button.
  • Go forward works like the browser's forward button.
src/navigator.rs
#[component]
fn Home() -> Element {
    let nav = navigator();

    // push
    nav.push(Route::PageNotFound { route: vec![] });

    // replace
    nav.replace(Route::Home {});

    // go back
    nav.go_back();

    // go forward
    nav.go_forward();

    rsx! { h1 { "Welcome to the Dioxus Blog!" } }
}

You might have noticed that, like Link, the Navigators push andreplace functions take a NavigationTarget. This means we can use eitherInternal, or External targets.

External Navigation Targets

Unlike a Link, the Navigator cannot rely on the browser (or webview) to

This means, that under certain conditions, navigation to external targets can