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 mediante
app/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: usa
next/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
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
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
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
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).