Pages et routage Next.js

Next.js utilise le routage basé sur le système de fichiers, ce qui signifie que les pages de votre application sont automatiquement déterminées par la structure du système de fichiers. Chaque fichier et dossier correspond à une route, vous n'avez donc pas besoin de configurer explicitement chaque chemin comme dans le routage React traditionnel. Cela rend le processus de développement plus intuitif et plus simple.

  • Relation entre les pages et les routes :Dans Next.js, chaque page est automatiquement associée à une route par un fichier dans le répertoire app/ ou pages/. Le chemin et le nom de fichier de chaque fichier déterminent l'URL de cette page.

  • Structure de page de base :Dans Next.js, une page est tout fichier .tsx ou .js dans le répertoire app/ ou pages/. Chaque fichier de page devient automatiquement une route dans l'application.

Le système de routage de Next.js est très flexible, prenant en charge les pages statiques, les routes dynamiques et les routes imbriquées, ce qui permet aux développeurs d'implémenter facilement des structures d'application complexes.

  • Routage basé sur le système de fichiers: Les pages et les routes sont automatiquement mappées viaapp/oupages/la structure des fichiers dans le répertoire.
  • Routes dynamiques: Vous pouvez utiliser des crochets ([ ]) pour créer des routes dynamiques et gérer les paramètres dynamiques dans l'URL.
  • Routes imbriquées: Vous pouvez créer des routes imbriquées à l'aide de sous-répertoires pour implémenter des structures de routes à plusieurs niveaux.
  • Navigation entre les routes: Utilisez lenext/linkcomposant pour implémenter la navigation entre les pages.

Next.js 13 a introduit un nouveau répertoire app, qui coexiste avec le répertoire pages traditionnel et offre un moyen plus flexible d'organiser les routes et les mises en page.

Supposons que la structure du répertoire du projet soit la suivante :

app/
├── page.tsx             # 对应根路径 /
├── about/
│   └── page.tsx         # 对应 /about
├── [slug]/
│   └── page.tsx         # 对应动态路径,如 /[slug]
  • page.tsxfichier : Chaque page aura unpage.tsxfichier. Ce fichier est le composant correspondant à cette route.
  • Routes dynamiques: Si des paramètres dynamiques se trouvent dans le chemin de la page, vous pouvez utiliser des crochets ([ ]) pour définir des routes dynamiques. Par exemple,[slug]indique que le chemin peut accepter n'importe quelle valeur comme leslugparamètre.

Pages dynamiques et

Next.js crée automatiquement des routes pour les fichiers dans votre dossier app/ ou pages/.

Voici quelques exemples de routes courantes :

  • app/page.tsxcorrespond à la/chemin.
  • app/about/page.tsxcorrespond à la/aboutchemin.
  • app/[slug]/page.tsxcorrespond à/[slug], et correspondra à n'importe quel chemin d'URL, tel que/post/1ou/product/xyz。

Routes dynamiques

Les routes dynamiques vous permettent de rendre dynamiquement des pages en fonction de différentes parties de l'URL.

Dans Next.js, vous pouvez implémenter des routes dynamiques en créant des dossiers ou des fichiers avec des crochets.

Par exemple, supposons que vous souhaitiez afficher un contenu différent en fonction de différents ID d'article, vous pouvez procéder ainsi :

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

[id]est un espace réservé pour la route dynamique. Il peut correspondre à n'importe quelidparamètre dans l'URL.

Obtenir les paramètres de route dynamique

Dans Next.js, vous pouvez utiliser le hook useParams pour accéder aux paramètres de route dynamique. Par exemple :

Exemple

'use client';

import { useParams } from 'next/navigation';

export default function Post() {
  const params = useParams();
  const { id } = params;  // Obtenir le paramètre de route dynamique `id`

  return <div>ID de l'article: {id}</div>;
}

Lorsqu'un utilisateur visite /post/123, id sera automatiquement défini sur 123 et affiché sur la page.

Routes imbriquées

Next.js prend également en charge les routes imbriquées, c'est-à-dire la création de sous-routes sous une route. Par exemple :

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

Cette approche donne à votre application une structure hiérarchique tout en gardant les chemins d'URL lisibles.

Règles de routage personnalisées

Si vous souhaitez personnaliser le comportement du routage, vous pouvez le configurer via le fichier next.config.js. Cependant, Next.js fournit déjà des fonctionnalités prêtes à l'emploi pour la plupart des besoins de routage courants, donc aucune configuration supplémentaire n'est requise.

Pages spéciales et fonctionnalités de routage

  • _app.jset_document.js: Dans Next.js,_app.jsest le composant racine de l'application, ce qui vous permet de fournir des mises en page et un état communs à toutes les pages._document.jssert principalement à modifier la structure du document HTML (par exemple,headetbodybalise).
  • _error.js: Vous pouvez personnaliser les pages d'erreur pour gérer les erreurs 404 ou d'autres types d'erreurs.

Exemple

Création d'une page statique

Prenons comme exemple la création d'une page statique simple. Créez un fichier about/page.tsx avec le contenu suivant :

Exemple

export default function AboutPage() {
  return <h1>À propos de nous</h1>;
}

Lorsque vous visitez le chemin /about, Next.js affichera automatiquement cette page.

Utilisation des routes dynamiques

Supposons que vous souhaitiez afficher une page en fonction de l'ID de l'article. Créez un fichier app/[id]/page.tsx avec le contenu suivant :

Exemple

import { useParams } from 'next/navigation';

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

  return <h1>ID de l'article: {id}</h1>;
}

Visiter /123 affichera ID de l'article : 123.

Navigation entre les routes

Next.js utilise le composant fourni par next/link pour la navigation entre les routes. Vous pouvez ajouter des liens dans vos pages pour naviguer vers d'autres pages.

Exemple

import Link from 'next/link';

export default function HomePage() {
  return (
    <div>
      <h1>Bienvenue sur Next.js!</h1>
      <Link href="/about">À propos de nous</Link>
    </div>
  );
}

<Link />Le composant est utilisé pour naviguer entre les pages tout en conservant l'expérience d'application monopage (SPA).

Autres extensions