next routes

Rotas dinâmicas para o próximo.js

Aviso de depreciação: este pacote foi uma escolha popular nos primeiros anos do Next.js e não é mais mantida. Por favor, verifique o próximo.js Docs para obter suas maneiras atuais de roteamento.

Fácil de usar rotas dinâmicas universais para Next.js

• Rota de estilo expresso e parâmetros correspondentes
• Solicite Middleware do manipulador para Express & Co
• Link e Router que geram URLs por definição de rota

Como usar

Instalar:

npm install next-routes --save

Crie routes.js dentro do seu projeto:

 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 arquivo é usado no servidor e no cliente.

API:

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

Argumentos:

• name - Nome da rota
• pattern -Padrão de rota (como Express, consulte o caminho para regexp)
• page - Página dentro ./pages a serem renderizadas

O componente da página recebe os parâmetros de URL correspondentes mesclados na query

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

No 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, você pode passar por um manipulador personalizado, por exemplo:

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

Certifique -se de usar server.js em seus scripts package.json :

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

No cliente

Importar Link e Router do seu arquivo routes.js para gerar URLs com base na definição de rota:

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

Adereços:

• route - Nome da rota ou URL para combinar (Alias: to )
• params - parâmetros opcionais para rotas nomeadas

Ele gera os URLs para href e as e renderiza next/link . Outros adereços como prefetch também funcionarão.

Exemplo de 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 - Nome da rota ou URL para combinar
• params - parâmetros opcionais para rotas nomeadas
• options - passado para Next.js

O mesmo trabalho com .replaceRoute() e .prefetchRoute()

Ele gera os URLs e chama next/router

---

Opcionalmente, você pode fornecer objetos Link e Router personalizados, por exemplo:

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

---

Links relacionados

• zeit/next.js - estrutura para aplicativos react renderizados pelo servidor
• Path-to-Regexp-caminho de estilo expresso para regexp