Nested Routes Rotas Aninhadas

Última atualização: 2026-11-03

Nested Routes Rotas Aninhadas

Rotas aninhadas expressam um layout mais suas páginas filhas como elementos Route pais e filhos: uma Route pai contém mais Routes, e o componente pai desenha um slot Outlet onde a página filha correspondente é renderizada. O layout clássico de administração — uma sidebar fixa com uma área de conteúdo que troca — é construído inteiramente a partir desse padrão. Cada nível mantém sua própria estrutura, então até uma hierarquia profunda de layouts continua fácil de entender.

GrupoRoteamento e Gerenciamento
TipoComponente
DesdeReact Router 6.4

ℹ️ Informação O editor transpila JSX para JavaScript e renderiza a UI real na sandbox; os componentes são montados automaticamente — sem render manual.

📝 Sintaxe

import { Routes, Route, Outlet } from 'react-router-dom'

function DashboardLayout() {
  return (
    <div>
      <aside>Sidebar (fixed by the parent)</aside>
      <main><Outlet /></main>   {/* the child route renders here */}
    </div>
  )
}

<Route path="dashboard" element={<DashboardLayout />}>
  <Route index element={<Overview />} />   {/* the default child page of /dashboard */}
  <Route path="team" element={<Team />} /> {/* /dashboard/team */}
</Route>

⚙️ Parâmetros

path (parent)O segmento de caminho pai; o caminho de uma Route filha é anexado a ele, enquanto uma / inicial o torna absoluto.
indexUm marcador especial em uma Route filha: a página filha padrão renderizada quando o próprio caminho pai (por exemplo, /dashboard) não tem mais segmentos.

Retorna:Nada (é um componente declarativo). A rota pai renderiza seu próprio element, e a posição do Outlet dentro dela decide onde o conteúdo da rota filha aparece.

▶ Exemplo

O exemplo roda direto: renderiza automaticamente ao expandir e edições valem na hora.

Saída:

O quadro externo e o título (o layout pai) nunca mudam, enquanto a caixa tracejada (a posição do Outlet) troca as páginas filhas conforme você clica — o resultado da renderização de Rotas pai/filha aninhadas mais Outlet (demonstração simulada).

💡 Pontos-chave

💡 Dica A rota index responde "o que deve aparecer quando visito o próprio /dashboard": ela dá ao caminho pai uma página padrão, renderizada pelo Outlet do layout pai.
ℹ️ Informação Um caminho filho sem barra inicial é anexado relativamente (path='team' -> /dashboard/team), enquanto uma / inicial conta a partir da raiz; a forma relativa é mais fácil de manter quando você reorganiza a hierarquia.
⚠️ Aviso Se o componente pai esquece o Outlet, uma rota filha correspondente não renderiza nada — uma área de conteúdo vazia é o sintoma mais comum desse erro.
Mais casos em breve.

📚 Tutoriais Relacionados

❓ Perguntas Frequentes

P O que é um Outlet?
R O espaço reservado de renderização de uma rota filha. Pense nele como um buraco cavado no componente pai: o elemento da Route filha correspondente é preenchido nele, e Outlets podem ser aninhados tão profundamente quanto desejar.
P Por que /dashboard está vazio?
R Porque nenhuma rota filha correspondeu. Adicione uma rota filha index à rota pai para fornecer uma página padrão.
P Rotas filhas podem ser aninhadas ainda mais?
R Sim. Outlets aninhados dentro de Outlets constroem uma árvore de layouts de qualquer profundidade, e cada nível pai possui sua própria estrutura fixa.
Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%