useParams
useParams geçerli URL tarafından doldurulan bir rotanın dinamik parametrelerini okumanızı sağlayan bir İstemci Bileşeni kancasıdır.
app/example-client-component.tsx
'use client'
import { useParams } from 'next/navigation'
export default function ExampleClientComponent() {
const params = useParams<{ tag: string; item: string }>()
// Route -> /shop/[tag]/[item]
// URL -> /shop/shoes/nike-air-max-97
// `params` -> { tag: 'shoes', item: 'nike-air-max-97' }
console.log(params)
return <></>
}Parameters
const params = useParams()useParams herhangi bir parametre almaz.
Returns
useParams geçerli rotanın doldurulmuş dinamik parametrelerini içeren bir nesne döndürür.
- Nesnedeki her özellik aktif bir dinamik segmenttir.
- Özellikler adı segmentin adıdır ve özellikler değeri segmentin ne ile doldurulduğudur.
- Özellik değeri, dinamik segmentin türüne bağlı olarak ya bir
stringya dastring'ler dizisi olacaktır. - Rota hiçbir dinamik parametre içermiyorsa,
useParamsboş bir nesne döndürür. pagesiçinde kullanılırsauseParams,nulldöndürür.
Örneğin:
| Route | URL | useParams() |
|---|---|---|
app/shop/page.js | /shop | null |
app/shop/[slug]/page.js | /shop/1 | { slug: '1' } |
app/shop/[tag]/[item]/page.js | /shop/1/2 | { tag: '1', item: '2' } |
app/shop/[...slug]/page.js | /shop/1/2 | { slug: ['1', '2'] } |
Version History
| Version | Changes |
|---|---|
v13.3.0 | useParams introduced. |