mirror of
https://github.com/TanStack/router.git
synced 2026-11-16 19:38:07 +00:00
When using relative routing we have 3 things to consider: 1) Is this relative to the current location? This is specifically relevant for using `to="."` and `to=".."` in layout routes 2) Is this relative to the rendered route location? 3) Should this be relative to some other route in the tree We have had a few issues where it hasn't been clear how relative routing is applied in various scenarios, and where the application differs, for example `to="."` and `to=".."` was treated differently. This PR applies the following: 1) when no from path is specified, navigation is done from the current location, this does not affect absolute paths but makes relative paths more standardised. 2) other relative navigations require a from location to be specified. This is achieved by setting Link and useNavigate to default to the current active location instead of the rendered route location. This also simplifies the logic in buildLocation as we no longer specifically cater for `to="."`. Included in this PR is the required changes to router-core (buildLocation), react-router and solid-router (Link and useNavigate), tests for both react-router and solid-router and an update to the docs to clarify the usage. This closes #4842 <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **New Features** * Added active-location hooks, origin-aware navigation helpers, programmatic Route API for Link generation, browser-history utilities, optional from origin for Navigate, and route fullPath exposure. * **Bug Fixes** * More deterministic relative navigation (., ..) resolution, preservation of search/params, and runtime warnings for invalid origins. * **Documentation** * Clarified relative-link semantics and updated examples. * **Tests** * Vastly expanded end-to-end coverage for relative navigation, masking, basepath, and trailing-slash permutations. <!-- end of auto-generated comment: release notes by coderabbit.ai --> --------- Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com> |
History
|
|
|---|---|---|
| .. | ||
| router | ||
| start | ||