next routes

Rute Dinamis untuk Next.js

PEMBERITAHUAN PEMBERITAHUAN: Paket ini adalah pilihan populer di tahun -tahun awal Next.js dan tidak lagi dipertahankan. Silakan periksa dokumen berikutnya.js untuk cara -cara peruteannya saat ini.

Rute dinamis universal yang mudah digunakan untuk Next.js

• Rute dan pencocokan parameter gaya ekspres
• Minta Middleware Handler untuk Express & Co
• Link dan Router yang menghasilkan URL dengan definisi rute

Cara menggunakan

Memasang:

npm install next-routes --save

Buat routes.js di dalam proyek Anda:

 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

File ini digunakan baik di server dan klien.

API:

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

Argumen:

• name - Nama Rute
• pattern -pola rute (seperti ekspres, lihat path-to-regexp)
• page - halaman di dalam ./pages yang akan diterjemahkan

Komponen halaman menerima parameter URL yang cocok digabungkan menjadi query

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

Di server

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

Secara opsional Anda dapat melewati penangan khusus, misalnya:

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

Pastikan untuk menggunakan server.js di skrip package.json Anda:

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

Pada klien

Impor Link dan Router dari file routes.js Anda untuk menghasilkan URL berdasarkan definisi rute:

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

Alat Peraga:

• route - nama rute atau url untuk mencocokkan (alias: to )
• params - Parameter opsional untuk rute bernama

Ini menghasilkan URL untuk href dan as dan membuat next/link . Alat peraga lain seperti prefetch juga akan berfungsi.

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

Argumen:

• route - nama rute atau URL untuk mencocokkan
• params - Parameter opsional untuk rute bernama
• options - diteruskan ke Next.js

Hal yang sama bekerja dengan .replaceRoute() dan .prefetchRoute()

Itu menghasilkan URL dan panggilan next/router

---

Secara opsional Anda dapat menyediakan Link khusus dan objek Router , misalnya:

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

---

Tautan terkait

• zeit/next.js - Kerangka kerja untuk aplikasi reaksi server -render
• PATT-TO-REGEXP-Jalur Express-Style ke RegExp