Exemplos de React Router (v7)

Exemplos de React Router (v7): rotas, loaders, auth, 404 | We.Inc

Exemplos de React Router 7 para copiar: configuração em cada modo, layouts aninhados, params, loaders e actions, rotas protegidas, páginas 404, rotas lazy e migração da v6.

Exemplos de React Router (v7)

O React Router 7 vem em um único pacote, react-router. Envolva o seu app em BrowserRouter para um roteamento simples, ou monte as rotas com createBrowserRouter e RouterProvider para usar loaders, actions e error boundaries. Aninhe rotas filhas sob um layout que renderiza Outlet, leia segmentos do caminho com useParams e query strings com useSearchParams.

As APIs que você mais usa

  • Necessidade
  • Use
  • Configurar rotas
  • createBrowserRouter + RouterProvider
  • Layout compartilhado
  • Rota pai + <Outlet />
  • useParams()
  • ?sort=price
  • useSearchParams()
  • Carregar dados
  • loader + useLoaderData()
  • URLs desconhecidas
  • path: "*"

Todos os exemplos abaixo foram escritos para o React Router 7 e importam de react-router. A pequena demo no topo é funcional, então você pode clicar pelas rotas aninhadas e params; ela roda na versão do router que este site usa, indicada nela.

  • Escolha um modo: declarativo para sites simples, data mode para loaders e actions, framework mode para um app completo com renderização no servidor.
  • Instale react-router e configure o router com o exemplo correspondente.
  • Adicione layouts com rotas filhas e um Outlet, depois segmentos dinâmicos para as páginas de detalhe.
  • Leve a busca de dados para os loaders e os envios de formulário para as actions, e adicione um error boundary na rota raiz.
  • Termine com uma rota * para URLs desconhecidas e ScrollRestoration no layout raiz.
  • Lance redirect() de um loader para checagens de autenticação; a página protegida nunca renderiza para quem não fez login.
  • Use NavLink com a prop end em links de índice para que Visão geral não fique destacado em todas as páginas filhas.
  • Mantenha filtros e abas nos search params em vez do state, assim um refresh ou um link compartilhado os preserva.
  • Coloque pelo menos um error boundary na rota raiz; qualquer rota sem um repassa os erros para a rota pai.
  • Em uma hospedagem estática, envie todo caminho desconhecido para index.html para que links diretos funcionem depois de um refresh.

Perguntas frequentes

Ainda preciso de react-router-dom na v7?

Não. Na v7 tudo é exportado de react-router. react-router-dom ainda instala e reexporta a mesma API para facilitar as atualizações, mas projetos novos só precisam de react-router.

Qual é a diferença entre data mode e framework mode?

O data mode é uma biblioteca: você mesmo monta o array de rotas com createBrowserRouter. O framework mode adiciona um plugin do Vite que lê app/routes.ts, divide o código por rota, gera tipos e pode renderizar no servidor.

Como faço uma página 404 no React Router?

Adicione uma rota com path "*" como a última filha da rota raiz. Ela corresponde a qualquer URL que nada mais tenha correspondido. Em uma hospedagem estática, faça também o servidor retornar index.html para caminhos desconhecidos, para que o router tenha a chance de exibi-la.

useParams retorna números?

Não, os params são sempre strings, ou undefined quando o segmento é opcional e está ausente. Converta com Number() e trate o caso em que o resultado não é um número válido.

Consigo manter código da v6 funcionando na v7?

Em grande parte, sim. Ative primeiro as seis future flags da v7 na v6 e corrija os avisos, depois atualize. O guia oficial diz que, depois disso, não há breaking changes além da troca do nome do pacote.

Como funciona a correspondência

  • O React Router classifica as rotas pelo quanto são específicas, não pela ordem, então /projects/new vence /projects/:projectId não importa qual você liste primeiro. Uma rota * só vence quando nada mais específico corresponde.
  • Os caminhos filhos são relativos ao pai. Sob uma rota /dashboard, uma filha com path settings corresponde a /dashboard/settings, e uma rota index corresponde ao próprio /dashboard.

Erros comuns

  • Misturar imports de react-router-dom e react-router depois de atualizar, o que pode carregar duas cópias e quebrar o contexto.
  • Esquecer o Outlet em um layout, de modo que as rotas filhas correspondem mas nada aparece.
  • Usar ScrollRestoration ou useLoaderData com o BrowserRouter simples; os dois precisam de um data router.
  • Buscar dados em useEffect quando um loader começaria a requisição antes de o componente renderizar.

Configurando a v7

As três formas de usar o React Router 7

  • Modo
  • Configuração
  • O que você ganha
  • Declarativo
  • <BrowserRouter> + <Routes>
  • Correspondência, links, params. Sem loaders.
  • Data
  • createBrowserRouter + <RouterProvider>
  • Loaders, actions, Form, error boundaries, lazy, restauração de rolagem
  • Framework
  • app/routes.ts + plugin Vite @react-router/dev
  • Tudo do data mode mais divisão de código por arquivo, geração de tipos e renderização no servidor

Instalação

Na v7 um único pacote cobre os apps web. react-router-dom ainda existe apenas como reexportação para imports antigos.

Data mode: createBrowserRouter + RouterProvider

As rotas são um array simples, o que libera loaders, actions, UI de carregamento e errorElement. Tudo é importado de react-router.

Modo declarativo: <BrowserRouter>

A configuração mínima e a mais próxima do código da v6. Não tem loaders nem actions; busque os dados dentro dos componentes.

Framework mode: app/routes.ts

O plugin do Vite de @react-router/dev lê este arquivo, divide o código por rota e gera tipos em ./+types/ para cada módulo de rota.

Framework mode: um módulo de rota tipado

Cada arquivo de rota exporta o seu loader e um componente padrão. Os tipos Route gerados dão tipos reais a params e loaderData.

Rotas aninhadas, params e search params

Rotas aninhadas e um layout com <Outlet>

O pai renderiza a UI compartilhada uma vez; <Outlet /> marca onde a filha correspondente aparece. Uma rota sem path, como a de baixo, é uma rota de layout.

Params de URL com useParams

Um segmento que começa com dois-pontos vira um param. Os params são sempre strings, então converta os números você mesmo.

Search params com useSearchParams

Funciona como useState, mas guarda o valor na query string, então os filtros sobrevivem a um refresh e podem ser compartilhados como link.

Loaders, actions, auth, erros, carregamento lazy e rolagem

Loaders, actions, <Form> e redirect

O loader roda antes de a rota renderizar. Enviar <Form method="post"> chama a action e, quando ela termina, o router recarrega os loaders da página. Retorne objetos simples; json() e defer() estão obsoletos na v7.

Rotas protegidas com redirect

Verifique a sessão em um loader pai e redirecione antes de qualquer filha renderizar. Passe o caminho original para poder mandar as pessoas de volta depois do login.

Rotas protegidas no modo declarativo

Sem loaders, um componente wrapper verifica a autenticação e renderiza <Navigate> no lugar da página.

404 catch-all e error boundaries

Um path * captura qualquer URL que nada mais tenha correspondido. errorElement (ou ErrorBoundary como componente) renderiza quando um loader, uma action ou a renderização lança um erro; useRouteError diz o que foi lançado.

Rotas lazy

lazy carrega o código de uma rota na primeira vez que alguém a visita. Retorne as propriedades da rota que você quer preencher, como Component e loader.

Restauração de rolagem

Renderize <ScrollRestoration /> uma vez no layout raiz de um data router. Ele rola para o topo em páginas novas e restaura a posição anterior ao voltar e avançar.

Migrando da v6

Com todas as future flags ativadas na v6, a mudança para a v7 não deve exigir nenhuma outra alteração de código. Publique cada flag separadamente para que um problema seja fácil de rastrear. A versão 8 também já saiu; a atualização funciona do mesmo jeito, com um novo conjunto de flags v8_ que você ativa ainda na 7.

Passando da v6 para a v7

  • Etapa
  • O que fazer
  • Versões mínimas
  • Node 20, React 18 e React DOM 18
  • Atualize a v6 primeiro
  • Instale a 6.x mais recente para que os avisos das future flags apareçam
  • Ative as future flags
  • v7_relativeSplatPath, v7_startTransition, v7_fetcherPersist, v7_normalizeFormMethod, v7_partialHydration, v7_skipActionErrorRevalidation
  • Compare formMethod em maiúsculas
  • useNavigation().formMethod agora é "POST", não "post"
  • Abandone json() e defer()
  • Retorne objetos simples dos loaders, ou Response.json() quando precisar de uma resposta de verdade
  • Troque o pacote
  • npm uninstall react-router-dom, npm install react-router, depois mude os imports para "react-router"
  • Imports só de DOM
  • RouterProvider também pode vir de "react-router/dom"

Um router dentro da página rodando react-router-dom 6.30 (a versão que este site usa, não a v7). Ele tem um layout /shop com uma lista de produtos e páginas de detalhe /shop/:productId, um search param ?sort e um 404 catch-all. O código das rotas é o mesmo na v7.

  • Luminária de mesa
  • Cadeira de escritório
  • Prateleira de parede

Demo

Início

Loja

Link quebrado

URL:

Layout da loja

Ordenar (search param)

Nome

Preço

Nenhum produto chamado "{id}".

useParams() retornou productId =

Voltar para a lista

Demo ao vivo: rotas aninhadas e params

Página inicial. Abra a loja.

404: a rota catch-all correspondeu.

Crie seu site grátis · Grátis para criar, sem cartão

Relacionados: Guias

Produto

Para quem é

Recursos

Recursos

Empresa

Mapa do site