Support use of external links when using useHref in RouterProvider

[Niznikr]

Provide a general summary of the feature here

The enhancements from #5864 have been great to support features we use from React Router. We are running into an issue though with the fact that when passing useHref to RouterProvider we lose the ability to use external links as all RAC href values get passed to useHref. It would be convenient to have a way to opt-out of useHref or detect an external link so both kinds can exist in an app.

🤔 Expected Behavior?

Set useHref in RouterProvider with React Router's version. There is a way to pass https://www.google.com to a RAC href prop and opt-out of passing it to useHref so that the final value is https://www.google.com.

😯 Current Behavior

Set useHref in RouterProvider with React Router's version. Passing https://www.google.com to a RAC href prop results in [current_url]/https://www.google.com.

💁 Possible Solution

Add an optional prop for RAC where href and routerOptions are available to opt-out of passing it through useHref or detect an external link similar to how RR does this https://github.com/remix-run/react-router/blob/main/packages/react-router-dom/index.tsx#L958-L982

🔦 Context

I want RAC links to support both client-side routing and external links simultaneously when using useHref in RouterProvider.

💻 Examples

No response

🧢 Your Company/Team

No response

🕷 Tracking Issue

No response

[LFDanLu]

Could you wrap React Router's useHref in your own function and determine whether to return https://www.google.com or [current_url]/https://www.google.com. and pass that into RouterProvider?

[theMosaad]

For anyone coming here looking for a copy-pastable solution

function useAbsoluteHref(path: string) {
  const relative = useHref(path);
  if (
    path.startsWith("https://") ||
    path.startsWith("http://") ||
    path.startsWith("mailto:")
  ) {
    return path;
  }
  return relative;
}

source: https://github.com/argos-ci/argos/blob/4822931b05c78e1b4a79e15cf4437fb0297369a6/apps/frontend/src/router.tsx#L21-L31

[evadecker]

Not the prettiest, but I was able to extend href support when using React-Aria and TanStack Router with the following:

// __root.tsx

import {
  type NavigateOptions,
  Outlet,
  type ToOptions,
  createRootRouteWithContext,
  useRouter,
} from "@tanstack/react-router";
import { RouterProvider } from "react-aria-components";

declare module "react-aria-components" {
  interface RouterConfig {
    href: ToOptions | string;
    routerOptions: Omit<NavigateOptions, keyof ToOptions>;
  }
}

export const Route = createRootRoute()({
  component: RootRoute,
});

function RootRoute() {
  const router = useRouter();

  return (
    <RouterProvider
      navigate={(path, options) =>
        router.navigate(
          typeof path === "string" ? { ...options } : { ...path, ...options },
        )
      }
      useHref={(path) =>
        typeof path === "string" ? path : router.buildLocation(path).href
      }
    >
      <Outlet />
    </RouterProvider>
  );
}

typeof path === "string" assumes an external link, while ToOptions is used for internal routing.

In your component you'd use:

// External links are strings
<Link href="https://github.com">GitHub</Link>

// Internal links are ToOptions objects
<Link href={{ to: '/about' }}>About</Link>

This supports params as well:

const myPostId = ...; // fetch param info

// Add params to your link
<Link href={{ to: '/post/$postId', { params: { postId: myPostId } }}>View Post</Link>

[christofferbergj]

My two cents for TanStack Router.

declare module 'react-aria-components' {
  interface RouterConfig {
    href: ToOptions['to'] | (string & {})
    routerOptions: Omit<NavigateOptions, keyof ToOptions>
  }
}

<RouterProvider
  navigate={(to, options) => router.navigate({ to, ...options })}
  useHref={(to) => buildHref(to, router)}
>
  <Outlet />
</RouterProvider>

const ABSOLUTE_URL_PREFIXES = ['https://', 'http://', 'mailto:'] as const

function buildHref(to: ToOptions['to'] | (string & {}), router: RegisteredRouter): string {
  if (!to) return ''

  if (ABSOLUTE_URL_PREFIXES.some((prefix) => to.startsWith(prefix))) {
    return to
  }

  return router.buildLocation({ to }).href
}