next routes

Routes dynamiques pour next.js

Avis de dépréciation: Ce package était un choix populaire dans les premières années de Next.js et n'est plus maintenu. Veuillez vérifier les documents suivants.

Utilisation des routes dynamiques universelles faciles à utiliser pour next.js

• Route et paramètres de style express correspondant
• Demandez du middleware pour express & co
• Link et Router qui génèrent des URL par définition de l'itinéraire

Comment utiliser

Installer:

npm install next-routes --save

Créer routes.js à l'intérieur de votre projet:

 const routes = require ( 'next-routes' )

// Name   Page      Pattern
module . exports = routes ( ) // ----   ----      -----
  . add ( 'about' ) // about  about     /about
  . add ( 'blog' , '/blog/:slug' ) // blog   blog      /blog/:slug
  . add ( 'user' , '/user/:id' , 'profile' ) // user   profile   /user/:id
  . add ( '/:noname/:lang(en|es)/:wow+' , 'complex' ) // (none) complex   /:noname/:lang(en|es)/:wow+
  . add ( { name : 'beta' , pattern : '/v3' , page : 'v3' } ) // beta   v3        /v3

Ce fichier est utilisé à la fois sur le serveur et le client.

API:

• routes.add([name], pattern = /name, page = name)
• routes.add(object)

Arguments:

• name - Nom de l'itinéraire
• pattern - Modèle d'itinéraire (comme express, voir path-to-regexp)
• page - Page à l'intérieur ./pages à rendre

Le composant de page reçoit les paramètres d'URL correspondants fusionnés dans query

 export default class Blog extends React . Component {
  static async getInitialProps ( { query } ) {
    // query.slug
  }
  render ( ) {
    // this.props.url.query.slug
  }
} 

Sur le serveur

 // server.js
const next = require ( 'next' )
const routes = require ( './routes' )
const app = next ( { dev : process . env . NODE_ENV !== 'production' } )
const handler = routes . getRequestHandler ( app )

// With express
const express = require ( 'express' )
app . prepare ( ) . then ( ( ) => {
  express ( ) . use ( handler ) . listen ( 3000 )
} )

// Without express
const { createServer } = require ( 'http' )
app . prepare ( ) . then ( ( ) => {
  createServer ( handler ) . listen ( 3000 )
} )

Éventuellement, vous pouvez passer un gestionnaire personnalisé, par exemple:

 const handler = routes . getRequestHandler ( app , ( { req , res , route , query } ) => {
  app . render ( req , res , route . page , query )
} )

Assurez-vous d'utiliser server.js dans vos scripts package.json :

 "scripts" : {
  "dev" : " node server.js " ,
  "build" : " next build " ,
  "start" : " NODE_ENV=production node server.js "
}

Sur le client

Importez Link et Router à partir de votre fichier routes.js pour générer des URL en fonction de la définition de l'itinéraire:

Exemple Link

 // pages/index.js
import { Link } from '../routes'

export default ( ) => (
  < div >
    < div > Welcome to Next.js! </ div >
    < Link route = "blog" params = { { slug : 'hello-world' } } >
      < a > Hello world </ a >
    </ Link >
    or
    < Link route = "/blog/hello-world" >
      < a > Hello world </ a >
    </ Link >
  </ div >
)

API:

• <Link route='name'>...</Link>
• <Link route='name' params={params}> ... </Link>
• <Link route='/path/to/match'> ... </Link>

Accessoires:

• route - Nom de l'itinéraire ou URL à correspondre (alias: to )
• params - Paramètres facultatifs pour les routes nommées

Il génère les URL pour href et as et rend next/link . D'autres accessoires comme prefetch fonctionneront également.

Exemple Router

 // pages/blog.js
import React from 'react'
import { Router } from '../routes'

export default class Blog extends React . Component {
  handleClick ( ) {
    // With route name and params
    Router . pushRoute ( 'blog' , { slug : 'hello-world' } )
    // With route URL
    Router . pushRoute ( '/blog/hello-world' )
  }
  render ( ) {
    return (
      < div >
        < div > { this . props . url . query . slug } </ div >
        < button onClick = { this . handleClick } > Home </ button >
      </ div >
    )
  }
}

API:

• Router.pushRoute(route)
• Router.pushRoute(route, params)
• Router.pushRoute(route, params, options)

Arguments:

• route - nom de route ou URL pour correspondre
• params - Paramètres facultatifs pour les routes nommées
• options - passé à next.js

Le même fonctionne avec .replaceRoute() et .prefetchRoute()

Il génère les URL et appelle next/router

---

En éventuellement, vous pouvez fournir des objets Link et Router personnalisés, par exemple:

 const routes = module . exports = require ( 'next-routes' ) ( {
  Link : require ( './my/link' )
  Router : require ( './my/router' )
} ) 

---

Liens connexes

• zeit / next.js - framework pour les applications de réaction rendues serveur
• Path-to-regexp - chemin de style express vers le regexp