動的ルート
事前に正確なセグメント名がわからず、動的データからルートを作成したい場合、リクエスト時に入力される、またはビルド時に事前レンダリングされる動的セグメントを使用できます。
規則
動的セグメントは、ファイルまたはフォルダ名を角括弧で囲むことで作成できます:[セグメント名]
。例えば、[id]
や[slug]
などです。
動的セグメントには、useRouter
からアクセスできます。
例
例えば、ブログには pages/blog/[slug].js
というルートがあり、[slug]
はブログ投稿の動的セグメントです。
ルート | 例URL | params |
---|---|---|
pages/blog/[slug].js | /blog/a | { slug: 'a' } |
pages/blog/[slug].js | /blog/b | { slug: 'b' } |
pages/blog/[slug].js | /blog/c | { slug: 'c' } |
キャッチオールセグメント
動的セグメントは、角括弧内に省略記号を追加することで、キャッチオールの後続セグメントに拡張できます:[...セグメント名]
。
例えば、pages/shop/[...slug].js
は /shop/clothes
にマッチし、/shop/clothes/tops
、/shop/clothes/tops/t-shirts
などにもマッチします。
ルート | 例URL | params |
---|---|---|
pages/shop/[...slug].js | /shop/a | { slug: ['a'] } |
pages/shop/[...slug].js | /shop/a/b | { slug: ['a', 'b'] } |
pages/shop/[...slug].js | /shop/a/b/c | { slug: ['a', 'b', 'c'] } |
オプションのキャッチオールセグメント
キャッチオールセグメントは、パラメータを二重の角括弧で囲むことでオプションにできます:[[...セグメント名]]
。
例えば、pages/shop/[[...slug]].js
は /shop/clothes
、/shop/clothes/tops
、/shop/clothes/tops/t-shirts
に加えて、/shop
にもマッチします。
キャッチオールとオプションのキャッチオールセグメントの違いは、オプションの場合、パラメータのないルート(上記の例では /shop
)もマッチすることです。
ルート | 例URL | params |
---|---|---|
pages/shop/[[...slug]].js | /shop | { slug: undefined } |
pages/shop/[[...slug]].js | /shop/a | { slug: ['a'] } |
pages/shop/[[...slug]].js | /shop/a/b | { slug: ['a', 'b'] } |
pages/shop/[[...slug]].js | /shop/a/b/c | { slug: ['a', 'b', 'c'] } |
次のステップ
次に何をすべきかについての詳細情報は、以下のセクションをお勧めします