restore navigator

packages/router/src/hooks/use_navigator.rs

@@ -0,0 +1,62 @@
+use dioxus::prelude::ScopeState;
+
+use crate::{
+    prelude::{GenericNavigator, GenericRouterContext},
+    routable::Routable,
+};
+
+/// A hook that provides access to the navigator to change the router history. Unlike [`use_router`], this hook will not cause a rerender when the current route changes
+///
+/// > The Routable macro will define a version of this hook with an explicit type.
+///
+/// ```rust
+/// # use dioxus::prelude::*;
+/// # use dioxus_router::prelude::*;
+/// # use serde::{Deserialize, Serialize};
+/// #[derive(Clone, Serialize, Deserialize, Routable)]
+/// enum Route {
+///     #[route("/")]
+///     Index {},
+///     #[route("/:id")]
+///     Dynamic { id: usize },
+/// }
+///
+/// fn App(cx: Scope) -> Element {
+///     render! {
+///         Router {}
+///     }
+/// }
+///
+/// #[inline_props]
+/// fn Index(cx: Scope) -> Element {
+///     let navigator = use_navigator(&cx);
+///
+///     render! {
+///         button {
+///             onclick: move |_| { navigator.push(Route::Dynamic { id: 1234 }); },
+///             "Go to /1234"
+///         }
+///     }
+/// }
+///
+/// #[inline_props]
+/// fn Dynamic(cx: Scope, id: usize) -> Element {
+///     render! {
+///         p {
+///             "Current ID: {id}"
+///         }
+///     }
+/// }
+///
+/// # let mut vdom = VirtualDom::new(App);
+/// # let _ = vdom.rebuild();
+/// ```
+pub fn use_generic_navigator<R: Routable + Clone>(cx: &ScopeState) -> &GenericNavigator<R> {
+    &*cx.use_hook(|| {
+        let router = cx
+            .consume_context::<GenericRouterContext<R>>()
+            .expect("Must be called in a descendant of a Router component");
+
+        GenericNavigator(router)
+    })
+}

packages/router/src/hooks/use_route.rs

@@ -5,6 +5,8 @@ use crate::utils::use_router_internal::use_router_internal;
 
 /// A hook that provides access to information about the current routing location.
 ///
+/// > The Routable macro will define a version of this hook with an explicit type.
+///
 /// # Return values
 /// - None, when not called inside a [`GenericRouter`] component.
 /// - Otherwise the current route.

packages/router/src/hooks/use_router.rs

@@ -5,50 +5,7 @@ use crate::{
     utils::use_router_internal::use_router_internal,
 };
 
-/// A hook that provides access to information about the router. The Router will define a version of this hook with an explicit type.
-///
-/// ```rust
-/// # use dioxus::prelude::*;
-/// # use dioxus_router::prelude::*;
-/// # use serde::{Deserialize, Serialize};
-/// #[derive(Clone, Serialize, Deserialize, Routable)]
-/// enum Route {
-///     #[route("/")]
-///     Index {},
-///     #[route("/:id")]
-///     Dynamic { id: usize },
-/// }
-///
-/// fn App(cx: Scope) -> Element {
-///     render! {
-///         Router {}
-///     }
-/// }
-///
-/// #[inline_props]
-/// fn Index(cx: Scope) -> Element {
-///     let router = use_router(&cx);
-///
-///     render! {
-///         button {
-///             onclick: move |_| { router.push(Route::Dynamic { id: 1234 }); },
-///             "Go to /1234"
-///         }
-///     }
-/// }
-///
-/// #[inline_props]
-/// fn Dynamic(cx: Scope, id: usize) -> Element {
-///     render! {
-///         p {
-///             "Current ID: {id}"
-///         }
-///     }
-/// }
-///
-/// # let mut vdom = VirtualDom::new(App);
-/// # let _ = vdom.rebuild();
-/// ```
+/// A hook that provides access to information about the router.
 pub fn use_generic_router<R: Routable + Clone>(cx: &ScopeState) -> &GenericRouterContext<R> {
     use_router_internal(cx)
         .as_ref()