Navegación de rutas
En este capítulo aprenderás a usar React Router v6 para implementar navegación de páginas sin recarga, incluyendo rutas dinámicas y lectura de parámetros.
¿Por qué usar rutas?
En los sitios web multipágina tradicionales, cada clic en un enlace solicita una nueva página al servidor, lo que produce un parpadeo de pantalla en blanco.
Enrutamiento en el frontendHace que, cuando la URL cambie, JS controle qué componente se muestra, sin enviar solicitudes al servidor.
Beneficios:Transiciones fluidas, experiencia similar a una app nativa。
Conceptos principales de React Router v6
| Concepto | Función | Código correspondiente |
|---|---|---|
| Tabla de rutas | Define la asignación entre URL y componentes | <Routes> + <Route> |
| Salida de rutas | Lugar reservado donde se muestran las subrutas | <Outlet /> |
| Enlace de navegación | Navegar al hacer clic | <Link to="..."> |
| Ruta dinámica | Variable en la URL | /post/:id |
| Leer parámetros | Obtener el valor de la ruta dinámica | useParams() |
Instalación y configuración
$ npm install react-router-dom@6
Crear la configuración de rutas
Ejemplo
import { createBrowserRouter } from 'react-router-dom'
import App from '../App'
import HomePage from '../pages/HomePage'
import PostPage from '../pages/PostPage'
// createBrowserRouter crea una instancia de rutas
const router = createBrowserRouter([
{
path: '/', // App actúa como layout raíz
element: <App />,
children: [
{
index: true, // index: true indica la subruta predeterminada para la ruta /
element: <HomePage />
},
{
path: 'post/:id', // Ruta dinámica: :id coincide con cualquier valor
element: <PostPage />
}
]
}
])
export default router
Dos modos de enrutamiento:createBrowserRouterProduce URLs limpias (/post/1), requiere configuración del servidor. Si el entorno de despliegue es incierto, usacreateHashRouter, cuya URL incluye # (/#/post/1), sin necesidad de configuración del servidor.
Registrar rutas en main.jsx
Ejemplo
import React from 'react'
import ReactDOM from 'react-dom/client'
import { RouterProvider } from 'react-router-dom'
import router from './router'
import './index.css'
ReactDOM.createRoot(document.getElementById('root')).render(
<React.StrictMode>
{/* RouterProvider inyecta las rutas en la aplicación */}
<RouterProvider router={router} />
</React.StrictMode>
)
Usar Outlet en App.jsx
Ejemplo
import { Outlet } from 'react-router-dom'
import NavBar from './components/NavBar'
import './App.css'
function App() {
return (
<div className="app">
<NavBar />
<main className="container">
{/* Outlet es la salida de las rutas anidadas: el componente que coincide con la subruta se renderiza aquí */}
<Outlet />
</main>
<footer className="footer">
<p>© 2024 EJEMPLO Blog. Powered by React.</p>
</footer>
</div>
)
}
export default App
Link — Navegación declarativa
LinkReemplaza la etiqueta tradicional<a>, que no provoca recarga de página.
Ejemplo
function BlogCard({ id, title, summary, date, category }) {
return (
<Link to={`/post/${id}`} className="card-link">
<div className="card">
<span className="tag">{category}</span>
<h3>{title}</h3>
<p>{summary}</p>
<span className="date">{date}</span>
</div>
</Link>
)
}
No uses
<a href="....html">——esto hace que el navegador solicite una nueva página al servidor y toda la aplicación React se reinicialice. Usa<Link to="...">para poder cambiar sin recarga en el cliente.
useParams — Leer parámetros de ruta
En la página de detalles, es necesario extraer el ID del artículo de la URL para poder encontrar el artículo correspondiente.
Ejemplo
function PostPage() {
// useParams devuelve un objeto que contiene los parámetros de la URL
const { id } = useParams()
// Nota: id es una cadena; si necesitas un número, conviértelo con Number(id)
return (
<div>
<p>ID del artículo actual:{id}</p>
</div>
)
}
useNavigate — Navegación programática
En algunos escenarios es necesario navegar sin hacer clic en un enlace (por ejemplo: navegar después de enviar un formulario, o volver a la página de inicio cuando no se encuentra un artículo).
Ejemplo
function PostPage() {
const navigate = useNavigate()
const article = null // Supongamos que no se encontró el artículo
if (!article) {
// Si el artículo no existe, navega de vuelta a la página de inicio
return (
<div>
<p>El artículo no existe</p>
<button onClick={() => navigate('/')}>Volver a la página de inicio</button>
</div>
)
}
return <div>Detalles del artículo...</div>
}
Comparación de las APIs de enrutamiento: Vue3 vs React
| Función | Vue3 | React |
|---|---|---|
| Enlace de navegación | <RouterLink> | <Link> |
| Salida de rutas | <RouterView> | <Outlet> |
| Ruta dinámica | /post/:id | /post/:id |
| Leer parámetros | useRoute().params | useParams() |
| Navegación programática | useRouter().push() | useNavigate() |
Manos a la obra: página de detalles completa + integración de rutas
Primer paso: modificar BlogCard para admitir navegación al hacer clic
Ejemplo
import { Link } from 'react-router-dom'
function BlogCard({ id, title, summary, date, category }) {
return (
<Link to={`/post/${id}`} className="card-link">
<div className="card">
<span className="tag">{category}</span>
<h3>{title}</h3>
<p>{summary}</p>
<span className="date">{date}</span>
</div>
</Link>
)
}
export default BlogCard
Segundo paso: crear HomePage y PostPage
Ejemplo
import { useState, useMemo } from 'react'
import BlogCard from '../components/BlogCard'
import CategoryFilter from '../components/CategoryFilter'
function HomePage() {
const [articles] = useState([
{ id: 1, title: 'Guía completa para empezar con React', summary: 'Aprende React desde cero', category: 'React', date: '2024-05-10',
content: '<h2>¿Por qué aprender React?</h2><p>React es uno de los frameworks de frontend más populares...</p>' },
{ id: 2, title: 'Explicación detallada de la programación asíncrona en JS', summary: 'Entiende Promise y async/await', category: 'JavaScript', date: '2024-05-08',
content: '<h2>¿Qué es la asincronía?</h2><p>JS es de un solo hilo; las operaciones asíncronas pueden evitar que el hilo principal se bloquee...</p>' },
{ id: 3, title: 'Práctica de diseño con CSS Grid', summary: 'Implementa diseño responsive con Grid', category: 'CSS', date: '2024-05-05',
content: '<h2>Introducción a Grid</h2><p>Grid es un sistema de diseño bidimensional...</p>' },
])
const [activeCategory, setActiveCategory] = useState('Todos')
const categories = useMemo(() => {
return ['Todos', ...new Set(articles.map(a => a.category))]
}, [articles])
const filteredArticles = useMemo(() => {
if (activeCategory === 'Todos') return articles
return articles.filter(a => a.category === activeCategory)
}, [articles, activeCategory])
return (
<div>
<h2 className="section-title">Últimos artículos</h2>
<CategoryFilter
categories={categories}
activeCategory={activeCategory}
onCategoryChange={setActiveCategory}
/>
<p className="result-info">común{filteredArticles.length}artículo</p>
{filteredArticles.length === 0 ? (
<p className="empty-tip">No hay artículos en esta categoría</p>
) : (
<div className="article-grid">
{filteredArticles.map(article => (
<BlogCard key={article.id} {...article} />
))}
</div>
)}
</div>
)
}
export default HomePage
Ejemplo
import { useParams, Link } from 'react-router-dom'
import { useMemo } from 'react'
// Datos de los artículos (se cargarán desde una fuente externa en capítulos posteriores)
const articles = [
{ id: 1, title: 'Guía completa para empezar con React', category: 'React', date: '2024-05-10',
content: '<h2>¿Por qué aprender React?</h2><p>React es uno de los frameworks de frontend más populares...</p>' },
{ id: 2, title: 'Explicación detallada de la programación asíncrona en JS', category: 'JavaScript', date: '2024-05-08',
content: '<h2>¿Qué es la asincronía?</h2><p>JS es de un solo hilo...</p>' },
]
function PostPage() {
const { id } = useParams()
// Buscar el artículo por ID
const article = useMemo(() => {
return articles.find(a => a.id === Number(id))
}, [id])
// El artículo no existe
if (!article) {
return (
<div className="not-found">
<h2>El artículo no existe</h2>
<p>No se encuentra el artículo cuyo ID es{id}.</p>
<Link to="/">Volver a la página de inicio</Link>
</div>
)
}
// El artículo existe
return (
<article className="post-view">
<span className="category-tag">{article.category}</span>
<h1>{article.title}</h1>
<time>{article.date}</time>
{/* dangerouslySetInnerHTML es equivalente a v-html de Vue; ten en cuenta el riesgo de XSS */}
<div
className="content"
dangerouslySetInnerHTML={{ __html: article.content }}
/>
<Link to="/" className="back-link">← Volver a la página de inicio</Link>
</article>
)
}
export default PostPage
dangerouslySetInnerHTMLes la versión de React dev-html. Su nombre es deliberadamente largo para recordarte: no lo uses para renderizar contenido ingresado por el usuario, ya que existe riesgo de seguridad XSS. El contenido de aquí está escrito por el propio desarrollador, por lo que es seguro.
Añadir estilos de PostPage
Ejemplo
.post-view {
max-width: 720px;
margin: 0 auto;
}
.category-tag {
display: inline-block;
padding: 4px 12px;
background: #e3f2fd;
color: #1976d2;
border-radius: 12px;
font-size: 13px;
margin-bottom: 12px;
}
.post-view h1 {
font-size: 32px;
margin-bottom: 12px;
line-height: 1.4;
}
.post-view time {
display: block;
color: #999;
font-size: 14px;
margin-bottom: 30px;
}
.content {
line-height: 1.8;
font-size: 16px;
color: #333;
}
.content h2 {
margin: 24px 0 12px;
font-size: 22px;
}
.content p {
margin-bottom: 12px;
}
.back-link {
display: inline-block;
margin-top: 40px;
color: #1976d2;
text-decoration: none;
}
.not-found {
text-align: center;
padding: 60px 0;
}
Resumen del capítulo
En este capítulo has aprendido el núcleo de React Router v6: configuración de la tabla de rutas (createBrowserRouter), navegación con Link, salida anidada Outlet, rutas dinámicas /post/:id, lectura de parámetros con useParams y navegación programática con useNavigate.
Ahora el blog tiene una auténtica experiencia multipágina: navegas por la lista en la página de inicio y haces clic para entrar en la página de detalles y leer el contenido completo.
Otros temas