Páginas y rutas de Next.js

Next.js utiliza el enrutamiento por sistema de archivos, lo que significa que las páginas de tu aplicación se determinan automáticamente por la estructura del sistema de archivos. Cada archivo y carpeta corresponde a una ruta, sin necesidad de configurar explícitamente cada ruta como en el enrutamiento tradicional de React, lo que hace que el proceso de desarrollo sea más intuitivo y sencillo.

  • Relación entre páginas y rutas:En Next.js, cada página se asigna automáticamente a una ruta mediante archivos en el directorio app/ o pages/. La ruta y el nombre del archivo determinan la URL de la página.

  • Estructura básica de páginas:En Next.js, una página es cualquier archivo .tsx o .js en el directorio app/ o pages/. Cada archivo de página se convierte automáticamente en una ruta de la aplicación.

El sistema de enrutamiento de Next.js es muy flexible, admite páginas estáticas, rutas dinámicas y rutas anidadas, lo que permite a los desarrolladores implementar fácilmente estructuras de aplicación complejas.

  • Enrutamiento por sistema de archivos: las páginas y rutas se asignan medianteapp/opages/la estructura de archivos del directorio automáticamente.
  • Rutas dinámicas: se pueden usar corchetes ([ ]) para crear rutas dinámicas y manejar los parámetros dinámicos en la URL.
  • Rutas anidadas: se pueden crear rutas anidadas mediante subdirectorios para lograr una estructura de rutas de varios niveles.
  • Navegación de rutas: usanext/linkel componente para implementar la navegación entre páginas.

Next.js 13 introdujo el nuevo directorio app, que coexiste con el tradicional directorio pages y ofrece una forma más flexible de organizar rutas y diseños.

Supongamos que la estructura del directorio del proyecto es la siguiente:

app/
├── page.tsx             # 对应根路径 /
├── about/
│   └── page.tsx         # 对应 /about
├── [slug]/
│   └── page.tsx         # 对应动态路径,如 /[slug]
  • page.tsxArchivo: cada página tendrá unpage.tsxarchivo, y este archivo es el contenido del componente correspondiente a esa ruta.
  • Rutas dinámicas: si la ruta de la página contiene parámetros dinámicos, puedes usar corchetes ([ ]) para definir rutas dinámicas. Por ejemplo[slug]indica que la ruta puede aceptar cualquier valor comoslugparámetro.

Páginas y rutas predeterminadas

Next.js crea automáticamente rutas para los archivos en tus carpetas app/ o pages/.

A continuación, algunos ejemplos comunes de rutas:

  • app/page.tsxcorresponde a/la ruta.
  • app/about/page.tsxcorresponde a/aboutla ruta.
  • app/[slug]/page.tsxcorresponde a/[slug], coincidirá con cualquier ruta de URL, como/post/1o/product/xyz。

Rutas dinámicas

Las rutas dinámicas te permiten renderizar páginas dinámicamente según diferentes partes de la URL.

En Next.js, puedes implementar rutas dinámicas creando carpetas o archivos con corchetes.

Por ejemplo, si deseas renderizar contenido diferente según el ID del artículo, puedes hacerlo de la siguiente manera:

app/
├── [id]/
│   └── page.tsx        # 动态路由,匹配任何 `/[id]` 的路径

[id]es un marcador de posición de ruta dinámica, que puede coincidir con cualquieridparámetro en la URL.

Obtener parámetros de rutas dinámicas

En Next.js, puedes acceder a los parámetros de la ruta dinámica mediante el hook useParams. Por ejemplo:

Ejemplo

'use client';

import { useParams } from 'next/navigation';

export default function Post() {
  const params = useParams();
  const { id } = params;  // Obtener el parámetro de ruta dinámica `id`

  return <div>Post ID: {id}</div>;
}

Cuando el usuario accede a /post/123, id se asigna automáticamente como 123 y se muestra en la página.

Rutas anidadas

Next.js también admite rutas anidadas, es decir, crear subrutas bajo una ruta determinada. Por ejemplo:

app/
├── about/
│   ├── page.tsx          # /about 路由页面
│   ├── team/
│   │   └── page.tsx      # /about/team 子路由页面
│   └── contact/
│       └── page.tsx      # /about/contact 子路由页面

Esta forma hace que tu aplicación tenga una estructura jerárquica, manteniendo la legibilidad de la ruta URL.

Reglas personalizadas de rutas

Si deseas personalizar el comportamiento de las rutas, puedes configurarlo a través del archivo next.config.js. Sin embargo, Next.js ya proporciona funciones listas para usar para la mayoría de las necesidades comunes de enrutamiento, sin necesidad de configuración adicional.

Funciones especiales de páginas y rutas

  • _app.jsy_document.js: En Next.js,_app.jses el componente raíz de la aplicación, que te permite proporcionar un diseño y estado comunes para todas las páginas._document.jsse utiliza principalmente para modificar la estructura del documento HTML (por ejemplo,headybodyla etiqueta).
  • _error.js: puedes personalizar las páginas de error para manejar errores 404 u otros tipos de errores.

Ejemplo

Crear una página estática

Tomemos como ejemplo la creación de una página estática simple. Crea un archivo about/page.tsx con el siguiente contenido:

Ejemplo

export default function AboutPage() {
  return <h1>About Us</h1>;
}

Al acceder a la ruta /about, Next.js renderizará automáticamente esa página.

Uso de rutas dinámicas

Supón que deseas renderizar una página según el ID del artículo. Crea un archivo app/[id]/page.tsx con el siguiente contenido:

Ejemplo

import { useParams } from 'next/navigation';

export default function PostPage() {
  const { id } = useParams();

  return <h1>Post ID: {id}</h1>;
}

Acceder a /123 mostrará Post ID: 123.

Navegación de rutas

Next.js utiliza el componente proporcionado por next/link para la navegación entre rutas. Puedes agregar enlaces en las páginas para saltar a otras páginas.

Ejemplo

import Link from 'next/link';

export default function HomePage() {
  return (
    <div>
      <h1>Welcome to Next.js!</h1>
      <Link href="/about">About Us</Link>
    </div>
  );
}

<Link />El componente se utiliza para navegar entre páginas y mantener la experiencia de aplicación de una sola página (SPA).

Otras extensiones