react-router-dom

6.27.0

Minor Changes

Patch Changes

6.26.2

Patch Changes

6.26.1

Patch Changes

6.26.0

Minor Changes

Patch Changes

6.25.1

Patch Changes

6.25.0

Minor Changes

Patch Changes

6.24.1

Patch Changes

6.24.0

Minor Changes

Patch Changes

6.23.1

Patch Changes

6.23.0

Minor Changes

Patch Changes

6.22.3

Patch Changes

6.22.2

Patch Changes

6.22.1

Patch Changes

6.22.0

Minor Changes

Patch Changes

6.21.3

Patch Changes

6.21.2

Patch Changes

6.21.1

Patch Changes

6.21.0

Minor Changes

This fix was originally added in #10983 and was later reverted in #11078 because it was determined that a large number of existing applications were relying on the buggy behavior (see #11052)

The Bug The buggy behavior is that without this flag, the default behavior when resolving relative paths is to ignore any splat (*) portion of the current route path.

The Background This decision was originally made thinking that it would make the concept of nested different sections of your apps in <Routes> easier if relative routing would replace the current splat:

jsx <BrowserRouter> <Routes> <Route path="/" element={<Home />} /> <Route path="dashboard/*" element={<Dashboard />} /> </Routes> </BrowserRouter>

Any paths like /dashboard, /dashboard/team, /dashboard/projects will match the Dashboard route. The dashboard component itself can then render nested <Routes>:

```jsx function Dashboard() { return (

Dashboard

    <Routes>
      <Route path="/" element={<DashboardHome />} />
      <Route path="team" element={<DashboardTeam />} />
      <Route path="projects" element={<DashboardProjects />} />
    </Routes>
  </div>
);

} ```

Now, all links and route paths are relative to the router above them. This makes code splitting and compartmentalizing your app really easy. You could render the Dashboard as its own independent app, or embed it into your large app without making any changes to it.

The Problem

The problem is that this concept of ignoring part of a path breaks a lot of other assumptions in React Router - namely that "." always means the current location pathname for that route. When we ignore the splat portion, we start getting invalid paths when using ".":

```jsx // If we are on URL /dashboard/team, and we want to link to /dashboard/team: function DashboardTeam() { // ❌ This is broken and results in return A broken link to the Current URL;

// ✅ This is fixed but super unintuitive since we're already at /dashboard/team!
return <Link to="./team">A broken link to the Current URL</Link>;

} ```

We've also introduced an issue that we can no longer move our DashboardTeam component around our route hierarchy easily - since it behaves differently if we're underneath a non-splat route, such as /dashboard/:widget. Now, our "." links will, properly point to ourself inclusive of the dynamic param value so behavior will break from it's corresponding usage in a /dashboard/* route.

Even worse, consider a nested splat route configuration:

jsx <BrowserRouter> <Routes> <Route path="dashboard"> <Route path="*" element={<Dashboard />} /> </Route> </Routes> </BrowserRouter>

Now, a <Link to="."> and a <Link to=".."> inside the Dashboard component go to the same place! That is definitely not correct!

Another common issue arose in Data Routers (and Remix) where any <Form> should post to it's own route action if you the user doesn't specify a form action:

jsx let router = createBrowserRouter({ path: "/dashboard", children: [ { path: "*", action: dashboardAction, Component() { // ❌ This form is broken! It throws a 405 error when it submits because // it tries to submit to /dashboard (without the splat value) and the parent // `/dashboard` route doesn't have an action return <Form method="post">...</Form>; }, }, ], });

This is just a compounded issue from the above because the default location for a Form to submit to is itself (".") - and if we ignore the splat portion, that now resolves to the parent route.

The Solution If you are leveraging this behavior, it's recommended to enable the future flag, move your splat to it's own route, and leverage ../ for any links to "sibling" pages:

```jsx } />

function Dashboard() { return (

Dashboard

    <Routes>
      <Route path="/" element={<DashboardHome />} />
      <Route path="team" element={<DashboardTeam />} />
      <Route path="projects" element={<DashboardProjects />} />
    </Router>
  </div>
);

} ```

This way, . means "the full current pathname for my route" in all cases (including static, dynamic, and splat routes) and .. always means "my parents pathname".

Patch Changes

  • Updated dependencies:
  • @remix-run/router@1.14.0
  • react-router@6.21.0

6.20.1

Patch Changes

6.20.0

Minor Changes

Patch Changes

6.19.0

Minor Changes

Patch Changes

6.18.0

Minor Changes

Patch Changes

6.17.0

Minor Changes

The simplest approach to enabling a View Transition in your React Router app is via the new <Link unstable_viewTransition> prop. This will cause the navigation DOM update to be wrapped in document.startViewTransition which will enable transitions for the DOM update. Without any additional CSS styles, you'll get a basic cross-fade animation for your page.

If you need to apply more fine-grained styles for your animations, you can leverage the unstable_useViewTransitionState hook which will tell you when a transition is in progress and you can use that to apply classes or styles:

jsx function ImageLink(to, src, alt) { let isTransitioning = unstable_useViewTransitionState(to); return ( <Link to={to} unstable_viewTransition> <img src={src} alt={alt} style={{ viewTransitionName: isTransitioning ? "image-expand" : "", }} /> </Link> ); }

You can also use the <NavLink unstable_viewTransition> shorthand which will manage the hook usage for you and automatically add a transitioning class to the <a> during the transition:

css a.transitioning img { view-transition-name: "image-expand"; }

jsx <NavLink to={to} unstable_viewTransition> <img src={src} alt={alt} /> </NavLink>

For an example usage of View Transitions with React Router, check out our fork of the Astro Records demo.

For more information on using the View Transitions API, please refer to the Smooth and simple transitions with the View Transitions API guide from the Google Chrome team.

Please note, that because the ViewTransition API is a DOM API, we now export a specific RouterProvider from react-router-dom with this functionality. If you are importing RouterProvider from react-router, then it will not support view transitions. (#10928

Patch Changes

6.16.0

Minor Changes

Patch Changes

6.15.0

Minor Changes

Patch Changes

6.14.2

Patch Changes

6.14.1

Patch Changes

6.14.0

Minor Changes

```jsx // The default behavior will still serialize as FormData function Component() { let navigation = useNavigation(); let submit = useSubmit(); submit({ key: "value" }, { method: "post" }); // navigation.formEncType => "application/x-www-form-urlencoded" // navigation.formData => FormData instance }

async function action({ request }) { // request.headers.get("Content-Type") => "application/x-www-form-urlencoded" // await request.formData() => FormData instance } ```

``js // Opt-into JSON encoding withencType: "application/json"` function Component() { let navigation = useNavigation(); let submit = useSubmit(); submit({ key: "value" }, { method: "post", encType: "application/json" }); // navigation.formEncType => "application/json" // navigation.json => { key: "value" } }

async function action({ request }) { // request.headers.get("Content-Type") => "application/json" // await request.json() => { key: "value" } } ```

``js // Opt-into text encoding withencType: "text/plain"` function Component() { let navigation = useNavigation(); let submit = useSubmit(); submit("Text submission", { method: "post", encType: "text/plain" }); // navigation.formEncType => "text/plain" // navigation.text => "Text submission" }

async function action({ request }) { // request.headers.get("Content-Type") => "text/plain" // await request.text() => "Text submission" } ```

Patch Changes

6.13.0

Minor Changes

Existing behavior will no longer include React.startTransition:

```jsx {/.../}

```

If you wish to enable React.startTransition, pass the future flag to your component:

```jsx {/.../}

```

Patch Changes

6.12.1

[!WARNING] Please use version 6.13.0 or later instead of 6.12.1. This version suffers from a webpack/terser minification issue resulting in invalid minified code in your resulting production bundles which can cause issues in your application. See #10579 for more details.

Patch Changes

6.12.0

Minor Changes

Patch Changes

6.11.2

Patch Changes

6.11.1

Patch Changes

6.11.0

Minor Changes

Patch Changes

6.10.0

Minor Changes

Patch Changes

6.9.0

Minor Changes

Example JSON Syntax

```jsx // Both of these work the same: const elementRoutes = [{ path: '/', element: , errorElement: , }]

const componentRoutes = [{ path: '/', Component: Home, ErrorBoundary: HomeError, }]

function Home() { ... } function HomeError() { ... } ```

Example JSX Syntax

```jsx // Both of these work the same: const elementRoutes = createRoutesFromElements( } errorElement={\ } /> );

const componentRoutes = createRoutesFromElements( );

function Home() { ... } function HomeError() { ... } ```

In order to keep your application bundles small and support code-splitting of your routes, we've introduced a new lazy() route property. This is an async function that resolves the non-route-matching portions of your route definition (loader, action, element/Component, errorElement/ErrorBoundary, shouldRevalidate, handle).

Lazy routes are resolved on initial load and during the loading or submitting phase of a navigation or fetcher call. You cannot lazily define route-matching properties (path, index, children) since we only execute your lazy route functions after we've matched known routes.

Your lazy functions will typically return the result of a dynamic import.

jsx // In this example, we assume most folks land on the homepage so we include that // in our critical-path bundle, but then we lazily load modules for /a and /b so // they don't load until the user navigates to those routes let routes = createRoutesFromElements( <Route path="/" element={<Layout />}> <Route index element={<Home />} /> <Route path="a" lazy={() => import("./a")} /> <Route path="b" lazy={() => import("./b")} /> </Route> );

Then in your lazy route modules, export the properties you want defined for the route:

```jsx export async function loader({ request }) { let data = await fetchData(request); return json(data); }

// Export a Component directly instead of needing to create a React Element from it export function Component() { let data = useLoaderData();

return (
  <>
    <h1>You made it!</h1>
    <p>{data}</p>
  
);

}

// Export an ErrorBoundary directly instead of needing to create a React Element from it export function ErrorBoundary() { let error = useRouteError(); return isRouteErrorResponse(error) ? (

{error.status} {error.statusText}

) : (

{error.message || error}

); } ```

An example of this in action can be found in the examples/lazy-loading-router-provider directory of the repository.

🙌 Huge thanks to @rossipedia for the Initial Proposal and POC Implementation.

6.8.2

Patch Changes

6.8.1

Patch Changes

6.8.0

Minor Changes

tsx <Link to="https://neworigin.com/some/path"> {/* Document request */} <Link to="//neworigin.com/some/path"> {/* Document request */} <Link to="https://www.currentorigin.com/path"> {/* Client-side navigation */}

Patch Changes

6.7.0

Minor Changes

Patch Changes

6.6.2

Patch Changes

6.6.1

Patch Changes

6.6.0

Minor Changes

Patch Changes

6.5.0

Patch Changes

6.4.5

Patch Changes

6.4.4

Patch Changes

6.4.3

Patch Changes

6.4.2

Patch Changes

6.4.1

Patch Changes

6.4.0

Whoa this is a big one! 6.4.0 brings all the data loading and mutation APIs over from Remix. Here's a quick high level overview, but it's recommended you go check out the docs, especially the feature overview and the tutorial.

New APIs

New Features

Bug Fixes

Updated Dependencies