Router 运行时

pub fn Router<R: Routable + Clone>(props: RouterProps<R>) -> Element {
    use crate::{outlet::OutletContext, RouterContext};

    use_hook(|| {
        provide_router_context(RouterContext::new(props.config.call(())));
    });

    #[cfg(feature = "streaming")]
    dioxus_hooks::use_after_suspense_resolved(|| {
        dioxus_fullstack_core::commit_initial_chunk();
    });

    use_hook(|| {
        provide_context(OutletContext::<R>::new());
    });

    rsx! { Outlet::<R> {} }
}

struct RouterContextInner {
    unresolved_error: Option<ExternalNavigationFailure>,

    subscribers: Arc<Mutex<HashSet<ReactiveContext>>>,
    routing_callback: Option<AnyRoutingCallback>,

    failure_external_navigation: fn() -> Element,

    internal_route: fn(&str) -> bool,

    site_map: &'static [SiteMapSegment],
}

    pub fn current<R: Routable>(&self) -> R {
        let absolute_route = self.full_route_string();
        // If this is a child route, map the absolute route to the child route before parsing
        let mapping = consume_child_route_mapping::<R>();
        let route = match mapping.as_ref() {
            // ...
            None => {
                R::from_str(&absolute_route).map_err(|err| format!("Failed to parse route {err}"))
            }
        };

        match route {
            Ok(route) => route,
            Err(err) => {
                dioxus_core::throw_error(ParseRouteError { message: err });
                "/".parse().unwrap_or_else(|err| panic!("{err}"))
            }
        }
    }

        // If the current route is different from the one in the browser, replace the current route
        let current_route: R = myself.current();

        if current_route.to_string() != history.current_route() {
            myself.replace(current_route);
        }

== rebuild at "/blog"
   history.current_route() = Some("/blog/"), can_go_back = Some(false)
   html: <nav>...</nav><p>blog</p>
== rebuild at "/user/7/"
   history.current_route() = Some("/user/7"), can_go_back = Some(false)
   html: <nav><a href="/user/7" aria-current="page">u7</a>...</nav><p>user 7</p>
== rebuild at "/user/x"
   history.current_route() = Some("/"), can_go_back = Some(false)
   html: <nav>...<a href="/" class="on" aria-current="page">home</a>...</nav><p>home</p>
   root error boundary: Failed to parse route Route did not match:
Attempted Matches:
1) Route 'Home' ('/') did not match:
Found additional trailing segments: user/x
2) Route 'User' ('/user/:id') did not match:
Dynamic segment '(id:u32)' did not match: invalid digit found in string
3) Nest 'Nest0ParseError' ('/blog') did not match:
Static segment 'blog' did not match instead found 'user'

ERROR Unable to find a history provider in the renderer. Make sure your renderer supports the Router. Falling back to the in-memory history provider.
thread 'main' (1207570) panicked at ~/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/dioxus-router-0.7.10/src/contexts/router.rs:278:50:
Route did not match:
Attempted Matches:
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
ERROR Panic while rendering component `dioxus_router::components::router::Router<nohist::R>`: Any { .. }
ERROR Error while rendering component `dioxus_router::components::router::Router<nohist::R>`: Encountered panic: Any { .. }
html: 

    pub(crate) fn render() -> Element
    where
        R: Routable + Clone,
    {
        let router = use_router_internal().expect("Outlet must be inside of a router");
        let outlet: OutletContext<R> = use_outlet_context();
        let current_level = outlet.level();
        provide_context(outlet.next());

        if let Some(error) = router.render_error() {
            return if current_level == 0 {
                error
            } else {
                VNode::empty()
            };
        }

        router.current::<R>().render(current_level)
    }

    fn subscribe_to_current_context(&self) {
        if let Some(rc) = ReactiveContext::current() {
            rc.subscribe(self.subscribers.clone());
        }
    }

        self.inner.read().update_subscribers();

click listeners: [2, 3, 4, 6, 8, 10]
== rebuild at "/"
   history.current_route() = Some("/"), can_go_back = Some(false)
   renders: Shell=1 Home=1 User=0 BlogIndex=0
   html: <nav><a href="/user/7">u7</a><a href="/" class="on" aria-current="page">home</a><a href="https://example.com" rel="noopener noreferrer">ext</a><a href="/no/such/page" rel="noopener noreferrer">str</a><button>blog</button><button>back</button></nav><p>home</p>
   prevent_default after Link click: default_action_enabled = false
--- edits after clicking Link to User 7: 7 edits
  SetAttribute class=None id=8
  SetAttribute aria-current=None id=8
  SetAttribute aria-current=Text("page") id=10
  LoadTemplate <p> index=0 id=13
  CreateTextNode "user 7" id=14
  ReplacePlaceholder path=[0] m=1
  ReplaceWith id=12 m=1
== after Link click
   history.current_route() = Some("/user/7"), can_go_back = Some(true)
   renders: Shell=1 Home=1 User=1 BlogIndex=0
   html: <nav><a href="/user/7" aria-current="page">u7</a><a href="/">home</a><a href="https://example.com" rel="noopener noreferrer">ext</a><a href="/no/such/page" rel="noopener noreferrer">str</a><button>blog</button><button>back</button></nav><p>user 7</p>
== after navigator().push(BlogIndex)
   history.current_route() = Some("/blog/"), can_go_back = Some(true)
   renders: Shell=1 Home=1 User=1 BlogIndex=1
   html: <nav><a href="/user/7">u7</a><a href="/">home</a><a href="https://example.com" rel="noopener noreferrer">ext</a><a href="/no/such/page" rel="noopener noreferrer">str</a><button>blog</button><button>back</button></nav><p>blog</p>
== after navigator().go_back()
   history.current_route() = Some("/user/7"), can_go_back = Some(true)
   renders: Shell=1 Home=1 User=2 BlogIndex=1
   html: <nav><a href="/user/7" aria-current="page">u7</a><a href="/">home</a><a href="https://example.com" rel="noopener noreferrer">ext</a><a href="/no/such/page" rel="noopener noreferrer">str</a><button>blog</button><button>back</button></nav><p>user 7</p>

    let action = move |event: MouseEvent| {
        // Only handle events without modifiers
        if !event.modifiers().is_empty() {
            return;
        }
        // Only handle left clicks
        if event.trigger_button() != Some(dioxus_elements::input_data::MouseButton::Primary) {
            return;
        }

        // If we need to open in a new tab, let the browser handle it
        if new_tab {
            return;
        }

        // todo(jon): this is extra hacky for no reason - we should fix prevent default on Links
        if do_default && is_external {
            return;
        }

        event.prevent_default();

        if do_default && is_router_nav {
            router.push_any(to.clone());
        }

        if let Some(handler) = onclick {
            handler.call(event);
        }
    };

impl From<&str> for NavigationTarget {
    fn from(value: &str) -> Self {
        match try_router() {
            Some(router) => match router.internal_route(value) {
                true => NavigationTarget::Internal(value.to_string()),
                false => NavigationTarget::External(value.to_string()),
            },
            None => NavigationTarget::External(value.to_string()),
        }
    }
}

hydrated: {"url":"/user/7/","len":2,"page":"user 7","current":"","prevented":[]}
click #home: {"url":"/","len":3,"page":"home","current":"home","prevented":["home:true"]}
ctrl+click #u7: {"url":"/","len":3,"page":"home","current":"home","prevented":["u7:false"]}
click #u7: {"url":"/user/7","len":4,"page":"user 7","current":"u7","prevented":["u7:true"]}
history.back(): {"url":"/","len":4,"page":"home","current":"home","prevented":[]}
click #ext: {"url":"/","len":4,"page":"home","current":"home","prevented":["ext:false"]}
click #newtab: {"url":"/","len":4,"page":"home","current":"home","prevented":["newtab:false"]}

    pub fn push(&self, target: impl Into<NavigationTarget>) -> Option<ExternalNavigationFailure> {
        let target = target.into();
        {
            let mut write = self.inner.write_unchecked();
            match target {
                NavigationTarget::Internal(p) => {
                    let history = history();
                    history.push(p)
                }
                NavigationTarget::External(e) => return write.external(e),
            }
        }

        self.change_route()
    }

before: <button>go</button>
push returned Some(ExternalNavigationFailure("https://example.com/"))
after: <h1>External Navigation Failure!</h1><p>The application tried to programmatically navigate to an external page. This operation has failed. Click the link below to complete the navigation manually.</p><a>Click here to go back</a>

            let history = if let Some(base_path) = base_path() {
                let base_path = base_path.trim_matches('/');
                let base_path = format!("/{base_path}");
                let route = route.strip_prefix(&base_path).unwrap_or(&route);
                dioxus_history::MemoryHistory::with_initial_path(route).with_prefix(base_path)
            } else {
                dioxus_history::MemoryHistory::with_initial_path(&route)
            };

                // If there was an error while routing, return the error with a 404 status
                // Return a routing error if any of the errors were a routing error
                if let Some(routing_error) = error.downcast_ref::<ParseRouteError>().cloned() {
                    status_code = Some(StatusCode::NOT_FOUND);
                    out_message = Some(routing_error.to_string());
                }

== /
HTTP/1.1 200 OK
== /user/7
HTTP/1.1 200 OK
== /user/7/
HTTP/1.1 200 OK
== /user/x
HTTP/1.1 404 Not Found
== /nope
HTTP/1.1 404 Not Found

HTTP/1.1 404 Not Found
content-length: 259
date: Wed, 28 Oct 2026 11:54:39 GMT

Failed to parse route Route did not match:
Attempted Matches:
1) Route 'Home' ('/') did not match:
Found additional trailing segments: user/x
2) Route 'User' ('/user/:id') did not match:
Dynamic segment '(id:u32)' did not match: invalid digit found in string

== /nope/x
HTTP/1.1 200 OK
<p id="page" data-node-hydration="0"><!--node-id1-->not found: [&#34;nope&#34;, &#34;x&#34;]
== /user/x
HTTP/1.1 200 OK
<p id="page" data-node-hydration="0"><!--node-id1-->not found: [&#34;user&#34;, &#34;x&#34;]

#[component]
fn NotFound(rest: Vec<String>) -> Element {
  dioxus::fullstack::FullstackContext::commit_http_status(dioxus::fullstack::StatusCode::NOT_FOUND, None);
  rsx! { p { id: "page", "not found: {rest:?}" } }
}

HTTP/1.1 404 Not Found
content-type: text/html; charset=utf-8
age: 0
<p id="page" data-node-hydration="0"><!--node-id1-->not found: [&#34;nope&#34;, &#34;x&#34;]

fn match_hydration<O>(
    during_hydration: impl FnOnce() -> O,
    after_hydration: impl FnOnce() -> O,
) -> O {
    if is_hydrating() {
        let update = schedule_update();
        queue_effect(move || update());
        during_hydration()
    } else {
        after_hydration()
    }
}

    fn current_route(&self) -> String {
        match_hydration(|| self.initial_route(), || self.history.current_route())
    }

/        g4EY9oIYYRgv9g==                  10 字节  83 81 18 f6 82 18 61 18 2f f6
/user/7  g4EY9ogYZxgvGHUYcxhlGHIYLxg39g==  22 字节  83 81 18 f6 88 18 67 18 2f 18 75 18 73 18 65 18 72 18 2f 18 37 f6

== after Link click
   renders: Shell=1 Home=1 User=1 BlogIndex=0
== after navigator().push(BlogIndex)
   renders: Shell=1 Home=1 User=1 BlogIndex=1
== after navigator().go_back()
   renders: Shell=1 Home=1 User=2 BlogIndex=1