next routes

Rutas dinámicas para next.js

Aviso de deprecación: este paquete fue una opción popular en los primeros años de Next.js y ya no se mantiene. Consulte los documentos Next.js para obtener sus formas actuales de enrutamiento.

Rutas dinámicas universales fáciles de usar para Next.js

• Ruta de estilo expreso y parámetros coincidentes
• Middleware de controlador de solicitud para Express & Co
• Link y Router que generan URL por definición de ruta

Cómo usar

Instalar:

npm install next-routes --save

Crear routes.js dentro de su proyecto:

 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

Este archivo se usa tanto en el servidor como en el cliente.

API:

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

Argumentos:

• name - Nombre de ruta
• pattern -Patrón de ruta (como Express, ver Ruta a Regexp)
• page - página adentro ./pages a renderizar

El componente de la página recibe los parámetros de URL coincidentes fusionados en query

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

En el servidor

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

Opcionalmente puede pasar un controlador personalizado, por ejemplo:

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

Asegúrese de usar server.js en sus scripts package.json :

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

En el cliente

Importar Link y Router desde su archivo routes.js para generar URL en función de la definición de ruta:

Ejemplo 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>

Accesorios:

• route : nombre de ruta o URL para que coincida (alias: to )
• params : parámetros opcionales para rutas nombradas

Genera las URL para href y as y Renders next/link . Otros accesorios como prefetch también funcionarán.

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

Argumentos:

• route - nombre de ruta o URL para que coincida
• params : parámetros opcionales para rutas nombradas
• options - Pasado a Next.js

Lo mismo funciona con .replaceRoute() y .prefetchRoute()

Genera las URL y las llamadas next/router

---

Opcionalmente, puede proporcionar objetos Router y Link personalizados, por ejemplo:

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

---

Enlaces relacionados

• ZEIT/NEXT.JS - Marco para aplicaciones React renderizadas por el servidor
• ruta a la regla: ruta de estilo expreso a regexp