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

ConceptoFunciónCódigo correspondiente
Tabla de rutasDefine la asignación entre URL y componentes<Routes> + <Route>
Salida de rutasLugar reservado donde se muestran las subrutas<Outlet />
Enlace de navegaciónNavegar al hacer clic<Link to="...">
Ruta dinámicaVariable en la URL/post/:id
Leer parámetrosObtener el valor de la ruta dinámicauseParams()

Instalación y configuración

$ npm install react-router-dom@6

Crear la configuración de rutas

Ejemplo

// Ruta del archivo: src/router/index.jsx
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

// Ruta del archivo: src/main.jsx
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

// Ruta del archivo: src/App.jsx
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

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>
  )
}

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

import { useParams } from 'react-router-dom'

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

import { useNavigate } from 'react-router-dom'

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ónVue3React
Enlace de navegación<RouterLink><Link>
Salida de rutas<RouterView><Outlet>
Ruta dinámica/post/:id/post/:id
Leer parámetrosuseRoute().paramsuseParams()
Navegación programáticauseRouter().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

// Ruta del archivo: src/components/BlogCard.jsx
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

// Ruta del archivo: src/pages/HomePage.jsx
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

// Ruta del archivo: src/pages/PostPage.jsx
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

/* Ruta del archivo: src/App.css; añadir aquí los estilos de la página de detalles */
.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