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
- React Server Components explicados
- Exemplos de tabela de dados React com TanStack Table
- React com TypeScript
- Bibliotecas de UI para React
- React vs React Native
- Guia rápido de regex
- Como remover um URL da pesquisa do Google
- robots.txt Disallow All
Produto
Para quem é
- Para agências
- Para freelancers
- Para provedores de hospedagem
- Para plataformas SaaS
- Para startups
- Serviços financeiros
- Soluções para saúde
Recursos
Recursos
- Blog
- Central de Ajuda
- Ferramentas gratuitas para empresas
- Free UI Components
- Modelos
- Coleções de modelos
- Exemplos de sites
- Guias
- Comparações
- Alternativas
- Os melhores
- Avaliações
- Guias de preços
- Casos de uso
- Glossário e guias
- Integrações
- Desenvolvedores
- Benchmark
- Windows App